Payment Methods
| Method | Cards |
| Credit Cards | Visa |
| Tokenized Credit Card | MasterCard |
| American Express | |
| Discover | |
| JCB |
Tokenized Credit Card Expiration Notifications
Aria will store the last four digits of a credit card along with the card’s expiration dates (month and year) from the tokenized credit card being used for a transaction. These details need to be received as inputs along with the < bill_agreement_id> from the following parameters:
If these details are not received as inputs, then Aria will collect this info from the payment gateways using the <bill_agreement_id>. The credit card expiry notification emails will be sent for accounts where <pay_method_type> is 13.
Recurring Flag
Aria now sends the recurring flag indicators to Braintree to identify transactions that are associated with subscription-based billing. This is required to comply with Visa and Mastercard’s rules that apply to Braintree. The recurring flag values are the following:
- 0: do not return
- 1: return
Cardholder Initiated Transactions (CIT) and Merchant Initiated Transactions Support for Visa, MasterCard, and Discover
This feature sends flags distinguishing CIT and MIT within the <recurring_processing_model_ind> parameter of the following API calls:
- assign_acct_plan_m
- authorize_electronic_payment_m
- cancel_acct_plan_m
- collect_from_account_m
- create_acct_billing_group_m
- create_acct_complete_m
- create_order_m
- create_order_with_plan_m
- manage_pending_invoice_m
- replace_acct_plan_m
- settle_account_balance_m
- update_acct_billing_group_m
- update_acct_complete_m
- update_acct_plan_m
- update_acct_plan_multi_m
- update_payment_method_m
- validate_acct_fraud_scoring_m
The input values for the <recurring_processing_model_ind> are the following:
- 0: Cardholder-Initiated Transaction—Credentials on File: a credit card transaction initiated by the cardholder for a new order or a plan upgrade that uses a credit card that is currently stored in Aria. (Default)
- 1: Cardholder-Initiated Transaction—a credit card transaction initiated by the cardholder for a new account or creating an order that uses an alternate credit card that is not currently stored in Aria.
- 2: Merchant-Initiated Transaction—Standing Instruction – Recurring: a credit card transaction initiated by Aria’s clients for a recurring charge that uses a credit card that is currently stored in Aria.
- 3: Merchant-Initiated Transaction—Unscheduled Credentials on File: a credit card transaction initiated by Aria’s clients for a non-recurring charge (one-time order or plan upgrade) that uses a credit card that is currently stored in Aria.
The output field is <proc_initial_auth_txn_id>. This feature is available for Visa, MasterCard, and Discover.
Soft Descriptor support
This is the transaction description appearing on the buyer's credit card statement that displays a Merchant Name or Item Description.
To configure, navigate to the dialog below as follows: Configuration > Payments > Payment Gateways > Field Options:
3D Secure Authentication
Aria supports 3D Secure authentication for payment transactions processed through the Braintree Payment Gateway. When using the authorize_electronic_payment_m or update_payment_method_m call for tokenized cards or credit cards the following are the steps to take:
Step 1: Invoke the authorize_electronic_payment_m API with the credit card details, billing information and <attempt_3D_secure> as true.
Step 2: The API will return the client_auth_token and cc_single_use_token within the <proc_3dsecure_data> output.
Step 3: Use the client_auth_token, cc_single_use_token, and transaction amount to invoke the 3D Secure authentication page. Once the information is entered, press Submit.
Step 4: The 3D Secure authentication page will pop up, prompting for the password associated with the card. Please note, the merchant, amount, date, card number and username will populate on this screen. Once the password is entered, press Submit.
Step 5: The 3DS Nonce will display on the HTML page along with the 3DS Status as “authenticate_successful”.
Step 6: Call authorize_3dsecure_m and enter the 3DS Nonce in the <proc_field_name> field and verify authentication.
Step 7: Call collect_from_account_m and verify the collection amount is the same as the amount authorized.
3D Secure – Direct Post
Step 1: Within the direct post page, enter the collection amount, billing details, credit card details and <attempt_3d_secure> as true and press Submit.
Step 2: You will be redirected to the 3D Secure authentication page provided by the issuing bank to enter the password. Once the password is entered, press Submit.
Step 3: The response of this transaction will display “authenticate_successful”. Now that the transaction is authenticated, you will be able to use your direct post configuration settings to collection the payment by credit card or tokenized credit card.
Transaction Reference IDs (Failed Transactions)
Aria will parse unique transaction reference IDs returned from Braintree in the <proc_payment_id> parameter for declined transactions. Transactions include but are not limited to the following:
- Payments
- Authorizations
- Captures
- Voices
- Reverses
- Refunds
- Balance Inquires
If no reference ID is returned from Braintree, Aria returns a NULL value for <proc_payment_id>. The following API calls include the <proc_payment_id> output parameter:
- create_acct_complete_m
- update_acct_complete_m
- create_order_with_plan_m
- create_order_m
- assign_acct_plan_m
- replace_acct_plan_m
- update_acct_plan_m
- update_acct_plan_multi_m
- settle_account_balance_m
- collect_from_account_m
- authorize_electronic_payment_m
- validate_payment_information_m
- validate_acct_fraud_scoring_m
- gen_rb_m
- manage_pending_invoice_m
Card Verification Value (CVV)/ Address Verification Service (AVS) Configuration
With the Braintree integration, error codes can be returned by Aria for a specific CVV response. This configuration lies within the Collection Groups and Payment Gateways tabs in the UI (Configuration > Payments). See image below for possible configuration options:
The integration with Braintree also offers Address Verification Service responses. This configuration is also within the Collection Groups and Payment Gateways tabs in the UI (Configuration > Payments). See image below for possible configuration options:
$0 Authorizations / Authorization Reversals
When authorizing a card, Aria provides the option to authorize a $0 or $1 transaction on the card to ensure the card is in good standing prior to offering a service to the account. The system override settings listed in the image below are to reverse the authorizations on the card after the verifications. The settings can be enabled for all or specific card types accepted with this integration. This configuration in the UI is at the Collection Group level (Configuration > Payments > Collection Groups).
