collect_from_account_m
Summary
| API Name | collect_from_account_m |
|---|---|
| Class | transaction_services_m |
| Update Version | 61 |
Description
Initiates a real-time payment collection against a specified account using the electronic payment method on file (credit card, ACH/bank account, tokenized payment, etc.) or an alternate payment method provided in the request. You can collect a specific dollar amount, collect against specific invoices (specific_invoices_list), collect against specific master plan instances (specific_master_plan_instances_list), or collect against a specific statement. Payment application can follow FIFO (first-in first-out), FDFO (first-due first-out), Statement FIFO, or manual allocation based on the payment_application_method parameter. Returns processor response codes (CVV, AVS, CAVV) and the resulting transaction_id for tracking. This is one of the most commonly used APIs for on-demand payment processing outside the normal billing cycle.
Inputs
| Name | Type | Length | Required | Description | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| client_no | long | 22 | Yes |
Aria-assigned unique identifier indicating the Aria client providing service to this account. |
||||||||||||||||||||||||||||||||||||||||
| auth_key | string | 32 | No |
Aria-assigned unique key for authenticating the validity of the requestor. This key is passed with each method call. |
||||||||||||||||||||||||||||||||||||||||
| acct_no | long | 22 | Yes |
Aria-assigned account identifier. This value is unique across all Aria-managed accounts. Alternative required field: client_acct_id |
||||||||||||||||||||||||||||||||||||||||
| amount_to_collect | double | 12 | No |
The amount of money to collect from the account. The amount_to_collect is required unless one of the following is provided: invoice_no, master_plan_instance_no, client_master_plan_instance_id, statement_no, sequential_statement_no, or installment_message_id. If amount_to_collect is provided alongside any of those, only amount_to_collect will be used. Additionally, amount_to_collect is mandatory when specific_charge_transaction_id is provided. |
||||||||||||||||||||||||||||||||||||||||
| payment_method_no | long | 22 | No |
Aria-assigned sequence number for this payment method. Alternative field: client_payment_method_id |
||||||||||||||||||||||||||||||||||||||||
| client_payment_method_id | string | 32 | No |
Client-defined ID for this payment method. Alternative field: payment_method_no |
||||||||||||||||||||||||||||||||||||||||
| client_receipt_id | string | 50 | No |
Client-defined unique identifier used to track related system actions |
||||||||||||||||||||||||||||||||||||||||
| specific_charge_transaction_id | object | No |
A list of specific charges, see below |
|||||||||||||||||||||||||||||||||||||||||
| alt_pay_method | long | 2 | No |
If you want to use the account's current form of payment, leave this field empty. If you want to use an alternate credit card, enter "1" in this field. This field is required if the below alternate billing info fields are to be honored. |
||||||||||||||||||||||||||||||||||||||||
| cc_number | string | 24 | No |
Credit card number. |
||||||||||||||||||||||||||||||||||||||||
| cc_expire_mm | long | 2 | No |
Expiration month for the credit card payment instrument. |
||||||||||||||||||||||||||||||||||||||||
| cc_expire_yyyy | long | 4 | No |
Expiration year for the credit card payment instrument. |
||||||||||||||||||||||||||||||||||||||||
| bank_routing_num | string | 22 | No |
The American Banking Association (ABA) routing number for the financial institution. |
||||||||||||||||||||||||||||||||||||||||
| bank_acct_num | string | 32 | No |
The bank account number. |
||||||||||||||||||||||||||||||||||||||||
| bill_company_name | string | 100 | No |
Company name of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_first_name | string | 32 | No |
First name of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_middle_initial | string | 2 | No |
Middle initial of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_last_name | string | 32 | No |
Last name of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_address1 | string | 100 | No |
First address line of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_address2 | string | 100 | No |
Second address line of the billing contact. If you want to delete existing data in this field, leaving it blank, you must enter a '~' in this field. |
||||||||||||||||||||||||||||||||||||||||
| bill_city | string | 32 | No |
City of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_locality | string | 32 | No |
Use this field instead of the state_prov field to designate the state, province or other local designation as appropriate for addresses in all countries other than the United States, Australia, and Canada. This field is ignored for all United States, Australia and Canada addresses. |
||||||||||||||||||||||||||||||||||||||||
| bill_state_prov | string | 10 | No |
State or Province of the billing contact. The official postal-service codes for all United States, Australia and Canada states, provinces, and territories. This field does not support states, provinces or territories from other countries. Use the locality field for other countries. |
||||||||||||||||||||||||||||||||||||||||
| bill_zip | string | 16 | No |
Zip Code of the billing contact |
||||||||||||||||||||||||||||||||||||||||
| bill_country | string | 3 | No |
Country of the billing contact. The ISO-compliant 2-character country code abbreviation in uppercase. |
||||||||||||||||||||||||||||||||||||||||
| bill_email | string | 320 | No |
Email of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_phone | string | 25 | No |
Phone number of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_phone_extension | string | 20 | No |
Phone extension of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_cell_phone | string | 20 | No |
Cell phone number of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_work_phone | string | 25 | No |
Work phone number of the billing contact. |
||||||||||||||||||||||||||||||||||||||||
| bill_work_phone_extension | string | 20 | No |
Work phone extenstion of the billing contact |
||||||||||||||||||||||||||||||||||||||||
| cvv | string | 6 | No |
Card Verification Value, used to help verify a transaction is being requested by the card holder since this value is physically printed on the credit card. |
||||||||||||||||||||||||||||||||||||||||
| bank_acct_type | string | 32 | No |
The type of bank account being used. Allowed values:
|
||||||||||||||||||||||||||||||||||||||||
| bill_drivers_license_no | string | 32 | No |
Drivers license number of the billing contact |
||||||||||||||||||||||||||||||||||||||||
| bill_drivers_license_state | string | 2 | No |
Drivers license state of the billing contact. The official postal-service codes for all United States and Canada states, provinces, and territories. |
||||||||||||||||||||||||||||||||||||||||
| bill_taxpayer_id | string | 32 | No |
Taxpayer ID of the billing contact |
||||||||||||||||||||||||||||||||||||||||
| bill_address3 | string | 100 | No |
The third line of the billing address. |
||||||||||||||||||||||||||||||||||||||||
| alt_client_acct_group_id | string | 100 | No |
One-time collections account group to use for this specific call. Default collections group on the account is not changed. |
||||||||||||||||||||||||||||||||||||||||
| track_data1 | string | 300 | No |
Raw "track 1" data from a swiped credit card used in a card-present transaction to initiate this request |
||||||||||||||||||||||||||||||||||||||||
| track_data2 | string | 300 | No |
Raw "track 2" data from a swiped credit card used in a card-present transaction to initiate this request |
||||||||||||||||||||||||||||||||||||||||
| soft_descriptor | string | No |
Transaction description shown on the buyer's statement that displays a Merchant Name or Item Description typically. This field will be ignored if not supported/certified by the payment processor. |
|||||||||||||||||||||||||||||||||||||||||
| soft_descriptor_customer_service | string | No |
Transaction description shown on the buyer's statement that displays a City for Card Present transactions or a Phone Number for Card Not Present transactions. This field will be ignored if not supported/certified by the payment processor. |
|||||||||||||||||||||||||||||||||||||||||
| payment_application_method | long | No |
Possible values are 1, 2, 3, 4 or NULL. 1 is FIFO. 2 is FDFO. 3 is None (future manual allocation). 4 is Statement FIFO. If NULL, defaults will be taken from the client parameter DEFAULT_PAYMENT_COLLECTION_METHOD. |
|||||||||||||||||||||||||||||||||||||||||
| iban | string | 50 | No |
International Bank Account Number(IBAN). Used for the Direct Debit payment method. It consists of 16 to 34 alphanumeric characters. Only hyphen and space are allowed to format the IBAN. |
||||||||||||||||||||||||||||||||||||||||
| bank_check_digit | long | 2 | No |
Bank check digits enable a sanity check of the bank account number to confirm its integrity before submitting a transaction. Used for the Direct Debit payment method. |
||||||||||||||||||||||||||||||||||||||||
| bank_swift_cd | string | 15 | No |
SWIFT code is a standard format of Bank Identifier Codes (BIC). It is used for the Direct Debit payment method. It consists of 8 or 11 alphanumeric characters. Only hyphen and space are allowed to format the SWIFT code. It is required for IBAN. |
||||||||||||||||||||||||||||||||||||||||
| bank_country_cd | string | 2 | No |
Country of the bank. The ISO-compliant 2-character country code abbreviation in uppercase. Used for the Direct Debit payment method. It is required for IBAN and BBAN. |
||||||||||||||||||||||||||||||||||||||||
| mandate_id | string | 35 | No |
Used for the Direct Debit payment method. A mandate is signed by the debtor to authorize the creditor to collect a payment and to instruct the bank of the debtor to pay those collections. |
||||||||||||||||||||||||||||||||||||||||
| bank_id_cd | string | 10 | No |
Up to 10 digit numeric bank identifier code. Used for the Direct Debit payment method. Only hyphen and space are allowed to format the bank ID code. It is required for BBAN. |
||||||||||||||||||||||||||||||||||||||||
| bank_branch_cd | string | 10 | No |
Up to 10 digit numeric bank branch code. Used for the Direct Debit payment method. Only hyphen and space are allowed to format the bank branch code. |
||||||||||||||||||||||||||||||||||||||||
| specific_invoices_list | object | No |
A list of specific invoice charges, see below |
|||||||||||||||||||||||||||||||||||||||||
| specific_master_plan_instances_list | object | No |
A list of specific master plan instance charges, see below |
|||||||||||||||||||||||||||||||||||||||||
| fraud_filter | long | 1 | No |
Enable Fraud Filtering. This is supported if your payment processor supports this feature and has been certified with Aria. If no values are provided, the system will default to 2. Allowed values:
|
||||||||||||||||||||||||||||||||||||||||
| fraud_control_fields | object | No |
List of key-value pair parameters to control Fraud Control. Allowed values:
|
|||||||||||||||||||||||||||||||||||||||||
| recurring_processing_model_ind | long | 1 | No |
Defines a recurring payment type for Credit Card and Tokenized Credit Cards. A null value will default to 0 - Cardholder-Initiated Transaction - Credentials on File. Allowed values:
|
||||||||||||||||||||||||||||||||||||||||
| bill_contact_no | long | 22 | No |
The Aria-assigned unique identifier for the contact on this account to be used as the billing contact for the payment method. If bill_contact_no is included in the API request, all other billing contact parameters are ignored. |
||||||||||||||||||||||||||||||||||||||||
| client_acct_id | string | 50 | Yes |
Client-defined account identifier. Alternative required field: acct_no |
||||||||||||||||||||||||||||||||||||||||
| proc_field_override | array | No |
The processor-specific fields passed as an array of proc_field_name/proc_field_value key-value pairs. The allowable fields and values for the key-value pairs are highlighted in blue below. |
|||||||||||||||||||||||||||||||||||||||||
| bank_name | string | 100 | No |
Bank name for the account payment method |
||||||||||||||||||||||||||||||||||||||||
| bank_city | string | 100 | No |
Bank city for the account payment method |
||||||||||||||||||||||||||||||||||||||||
| bank_acct_holder_type | string | 32 | No |
This field denotes the bank account holder type. The value can be either individual or company. Allowed values:
|
||||||||||||||||||||||||||||||||||||||||
| mandate_signature_date | string | No |
The date, in yyyy-mm-dd format, on which the mandate was signed. |
|||||||||||||||||||||||||||||||||||||||||
| specific_statement | object | No |
A list of specific statements; applicable only when payment application method or default payment collection method is statement First-In-First-Out (FIFO), see below |
|||||||||||||||||||||||||||||||||||||||||
| specific_installment_message_id | object | No |
Note: This field is deprecated. Aria no longer supports specific_installment_message_id. |
|||||||||||||||||||||||||||||||||||||||||
| payoff_installment_ind | long | No |
Indicates if payment should be allocated to payoff future installment or future payment plan due. Allowable values are: 0 - Pay only installment due (default), 1 - Payoff installment or payment plan including amount not due yet. If Null, it's treated as the default. |
|||||||||||||||||||||||||||||||||||||||||
| payment_method_verification_code | string | 1000 | No |
The code provided by the account validator. |
||||||||||||||||||||||||||||||||||||||||
| emandate_signature | string | 1000 | No |
This is the electronic signature returned after successfully completing an e-mandate request through an e-Mandate service. |
||||||||||||||||||||||||||||||||||||||||
| client_payment_plan_id | string | No |
Client-defined unique payment plan id Alternative field: payment_plan_no |
|||||||||||||||||||||||||||||||||||||||||
| payment_plan_no | long | No |
Aria-assigned payment plan no Alternative field: client_payment_plan_id |
|||||||||||||||||||||||||||||||||||||||||
| specific_message_id_list | object | No |
A list of specific email message ID; applicable only when payment application method or default payment collection method is statement First-In-First-Out (FIFO). |
specific_charge_transaction_id fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| specific_charge_transaction_id | long | 22 | No |
Unique transaction ID for specific charges, usually when the account holder makes a purchase that is not part of their normal recurring charges. |
specific_invoices_list fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| invoice_no | long | No |
The Aria-assigned unique identifier for invoices. If a single invoice is provided, collection is attempted for the amount due for that invoice. If multiple invoices are provided, one collection is attempted for the combined amount due for all invoices specified. Payment is automatically applied to the invoice line items for the invoices provided (first-in, first-out). Note that invoice_no takes precedence over master_plan_instance_no, which in turn takes precedence over client_master_plan_instance_id. |
specific_master_plan_instances_list fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| master_plan_instance_no | long | 22 | No |
The Aria-assigned unique identifier for master plan instances (MPI). If a single MPI is provided, collection will be attempted for the total or current balance due (based on the client parameter setting) of that MPI. If multiple MPIs are provided, one collection will be attempted for the combined total / current balance due for all MPIs specified. Payment will be automatically applied to the invoice line items for the MPIs provided (first-in, first-out). Note that invoice_no takes precedence over master_plan_instance_no, which in turn takes precedence over client_master_plan_instance_id. |
| client_master_plan_instance_id | string | 100 | No |
The client-defined unique identifier for master plan instances (MPI). If a single MPI is provided, collection will be attempted for the total or current balance due (based on the client parameter setting) of that MPI. If multiple MPIs are provided, one collection will be attempted for the combined total / current balance due for all MPIs specified. Payment will be automatically applied to the invoice line items for the MPIs provided (first-in, first-out). Note that invoice_no takes precedence over master_plan_instance_no, which in turn takes precedence over client_master_plan_instance_id. |
fraud_control_fields fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| fraud_control_field_name | string | 100 | No |
List of Fraud Control field names. |
| fraud_control_field_value | string | 100 | No |
List of Fraud Control field values. |
proc_field_override fields
| proc_field_name | proc_field_value | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| transaction_type |
Defines a transaction type for Credit Cards and Tokenized Credit Cards. If a value is not entered, it will default to your client configuration settings. Please note that the values differ per processor. For a list of transaction types, please read our documentation. Allowed values:
|
||||||||||||||||||||||||||||
| client_3ds_nonce | The 3ds enriched nonce used for the card authorization. | ||||||||||||||||||||||||||||
| payer_auth_reference_id | Reference id for 3ds transaction session. | ||||||||||||||||||||||||||||
| payer_auth_transaction_mode |
The transaction mode identifies the channel from which the transactions are originated of Cybersource 3ds 2.0. Allowed values:
|
||||||||||||||||||||||||||||
| payer_auth_transaction_id | Authentication Transaction id for 3ds authorization. | ||||||||||||||||||||||||||||
| end_user_browser_accept_header | Browser Accept Header that was used for placing an online order. Some examples might include 'text/html,application/xhtml+xml,application/xml ;q=0.9,*/*;q=0.8'. | ||||||||||||||||||||||||||||
| end_user_browser_agent | Browser that was used for placing an online order. Some examples might include "Mozilla/5.0 (X11; Linux i586; rv:31.0) Gecko/20100101 Firefox/31.0". | ||||||||||||||||||||||||||||
| end_user_browser_color_depth | Browser color depth in bits per pixel. This should be obtained by using the browser's screen.colorDepth property. Accepted values: 1, 4, 8, 15, 16, 24, 32 or 48 bit color depth. | ||||||||||||||||||||||||||||
| end_user_browser_java_enabled_ind | Boolean value indicating if the shopper's browser is able to execute Java. | ||||||||||||||||||||||||||||
| end_user_browser_language | Browser supported language(as defined in IETF BCP 47). This should be obtained by using the browser's navigator.language property. | ||||||||||||||||||||||||||||
| end_user_browser_screen_height | Browser total height that was used for placing an online order. | ||||||||||||||||||||||||||||
| end_user_browser_screen_width | Browser total width that was used for placing an online order. | ||||||||||||||||||||||||||||
| end_user_browser_timezone_offset_mins | Time difference between UTC time and the shopper's browser local time, in minutes. | ||||||||||||||||||||||||||||
| pa_3ds_completion_ind | In Adyen, for 3DS v2.0 transaction, if the response of DDC is received within 10sec set this to 'Y', else set this to 'N'. | ||||||||||||||||||||||||||||
| pa_3ds_trans_status | In Adyen, for 3DS v2.0 transaction, if the response of Challenge Shopper is NOT received within 10mins set this to 'U', else set the value from Challenge shopper response. | ||||||||||||||||||||||||||||
| pa_3ds_termination_url | Termination url for 3DS transaction. | ||||||||||||||||||||||||||||
| pa_machine_id | HTTP cookie to be used in the HTTP header for Worldpay 3DS transaction. | ||||||||||||||||||||||||||||
| sca_exemption_type | Defines a exemption type indicator for 3D secure transactions. Depending upon the exemption reason, it can bypass Strong Customer Authentication. If a value is not entered, it will default to your client configuration settings. Please note that the values differ per processor. For a list of exemption types, please read our documentation. (values: -1 - Use client configuration settings for determining the exemption type. 0 - Transaction will be performed with no exemption. 1 - (Chase) Transaction will be performed with low value exemption.) | ||||||||||||||||||||||||||||
| mandate_collection_method |
Use this field to specify how the customer will authorize the mandate for direct debit collection. It is required for ACH, SEPA, and BACS. If the the mandate is collected online, the customer IP address and useragent must be collected and passed in the collection API. If offline, you must collect and maintain the authorization in your records. This is applicable for Stripe Payment Processor. Allowed values:
|
||||||||||||||||||||||||||||
| end_user_ip_address | IP address that was used for placing an online order. | ||||||||||||||||||||||||||||
| end_user_browser_agent | Browser that was used for placing an online order. Some examples might include "Mozilla/5.0 (X11; Linux i586; rv:31.0) Gecko/20100101 Firefox/31.0". | ||||||||||||||||||||||||||||
| bank_acct_holder_type |
The type of entity that holds the account. This is applicable for Stripe Payment Processor. Allowed values:
|
||||||||||||||||||||||||||||
| kount_session_id | kount_session_id is a unique identifier generated by Kount, a fraud prevention and risk management platform for Evertec. |
specific_statement fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| statement_no | long | No |
Statement number. |
|
| sequential_statement_no | string | No |
Sequential statement no. |
specific_message_id_list fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| message_id | long | No |
Unique identifier of message due reminder sent. |
Outputs
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| transaction_id | long | No |
The unique identifier for a given transaction |
|
| proc_cvv_response | string | No |
The processor return code from CVV validation. |
|
| proc_avs_response | string | No |
Processor return code from address validation |
|
| proc_cavv_response | string | No |
The processors return code for security validation. |
|
| proc_status_code | string | No |
The processor status code |
|
| proc_status_text | string | No |
The processors status description |
|
| proc_payment_id | string | No |
The processor payment ID |
|
| proc_auth_code | string | No |
Authorization code provided by the issuing bank |
|
| proc_merch_comments | string | No |
Additional information passed to payment processor |
|
| proc_initial_auth_txn_id | string | 100 | No |
Transaction ID from payment processor. If received as part of an auth request, it must be retained for future settlement and match the value from the auth response. It should also be used for future recurring transaction auths/settlement. |
| error_code | long | No |
Aria-assigned error identifier. 0 indicates no error. |
|
| error_msg | string | No |
Description of any error that occurred. "OK" if there was no error. |
|
| collection_errors | object | No | ||
| proc_fraud_filtering_info | object | No |
Fraud Filtering Response returned from Payment processor. |
|
| proc_payment_response_field_list | object | No |
Payment response fields returned by the processor for further actions if any. |
|
| collection_payment_method_no | long | No |
The payment method sequence no for the payment attempted during collection. |
collection_errors fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| collection_error_code | No | |||
| collection_error_msg | No |
proc_fraud_filtering_info fields
| Name | Type | Length | Required | Description |
|---|---|---|---|---|
| proc_fraud_country_status | string | 100 | No |
Fraud country status provided by the Payment processor. |
| proc_fraud_country_code | string | No |
Fraud country code provided by the Payment processor. |
proc_payment_response_field_list fields
| Name | Type | Length | Required | Description | ||||
|---|---|---|---|---|---|---|---|---|
| proc_payment_response_field_name | string | 100 | No |
Field name of various response returned by the processor, example: micro_deposit_verify_url. Allowed values:
|
||||
| proc_payment_response_field_value | string | 4000 | No |
Field value for the corresponding payment response field, example: Actual URL to be used for the micro deposit verification. |