`Payouts` Developer Guide {#payouts-about-guide} ================================================ This section describes how to use this guide and where to find further information. Audience and Purpose -------------------- This document is written for developers who want to use the `Cybersource` APIs to integrate `Cybersource` `Payouts` services into their transaction management system. Conventions ----------- This statement is used in this document: > An *Important* statement contains information essential to successfully completing a task or learning a concept. Related Documentation --------------------- Visit the [`Cybersource` documentation hub](https://developer.cybersource.com/docs.md "") on the Cybersource Developer Center for links to further documentation resources. Customer Support ---------------- For support information about any service, visit the Support Center: Recent Revisions to This Document {#payouts-doc-revs} ===================================================== 26.06.01 -------- Updated these sections: * [Business Application Identifier](/docs/cybs/en-us/payouts/developer/fdiglobal/so/payouts-dev/payouts-ref-intro/payouts-appendix-bai.md "") * [Required Fields for a Dual-Message AFT Request for FDC Nashville Global](/docs/cybs/en-us/payouts/developer/fdiglobal/so/payouts-dev/payouts-services-intro/payouts-services-auth-dual-message-aft-intro/payouts-services-auth-dual-message-aft-reqfields-f.md "") * [Required Fields for a Dual-Message AFT Reversal or Refund for FDC Nashville Global](/docs/cybs/en-us/payouts/developer/fdiglobal/so/payouts-dev/payouts-services-intro/payouts-services-auth-dual-message-aft-rev-refund-/payouts-services-auth-dual-message-aft-rev-refund-.md "") {#payouts-doc-revs_june2026updateslist} 25.09.01 -------- Added [Process a Dual Message AFT Reversal or Refund](/docs/cybs/en-us/payouts/developer/fdiglobal/so/payouts-dev/payouts-services-intro/payouts-services-auth-dual-message-aft-rev-refund-.md ""), [Required Fields for a Dual-Message AFT Reversal or Refund for FDC Nashville Global](/docs/cybs/en-us/payouts/developer/fdiglobal/so/payouts-dev/payouts-services-intro/payouts-services-auth-dual-message-aft-rev-refund-/payouts-services-auth-dual-message-aft-rev-refund-.md ""), and [Optional Fields for a Dual-Message AFT Reversal or Refund](/docs/cybs/en-us/payouts/developer/fdiglobal/so/payouts-dev/payouts-services-intro/payouts-services-auth-dual-message-aft-rev-refund-/payouts-services-auth-dual-message-aft-rev-refu-0.md ""). 25.08.01 -------- This revision contains only editorial changes and no technical updates. 25.05.01 -------- Initial release. Introduction to `Payouts` {#payouts-intro-intro} ================================================ The `Payouts` service transfers funds from one account to another account using this two-step transaction process: 1. An *account funding transaction* (AFT) withdraws funds from a sender's account using standard credit card processing. 2. An *original credit transaction* (OCT) deposits the funds into a recipient's account. An AFT and OCT are independent transactions, however, an AFT often precedes a corresponding OCT. During standard payment transactions, you initiate debits and credits to receive payments from cardholders for your goods and services. With `Payouts`, you provide a money transfer service by initiating AFT and OCT transactions that move funds between accounts. These are the money transfer types: * An *account-to-account* payment transfers funds between accounts owned by the same person. * A *business-to-person* payment transfers funds between a merchant and a cardholder. * A *person-to-person* payment transfers funds between two cardholders. For a person-to-person funds transfer, Pull and Push services are executed. When an AFT is authorized for a person-to-person transaction, the funds are available and can be withdrawn from the sender's account. This service is known as a *Pull* service. A subsequent OCT is authorized, and the funds are deposited into the recipient's account. This service is known as a *Push* service. The `Payouts` system ensures that both Pull and Push services are executed efficiently, providing a seamless experience for users. By leveraging `Payouts`, businesses and individuals can streamline their financial operations, making transactions more efficient and reliable. No merchant goods are involved in `Payouts` transactions. `FDC Nashville Global` support AFT services only. > You must receive approval from ` FDC Nashville Global ` before using the AFT service. Contact ` FDC Nashville Global ` to register for the AFT program. Supported Card Types -------------------- Recipient card type for AFTs: * Mastercard * Visa These card types are supported : * Mastercard * Visa These currencies are supported: CAD, GBP, and USD. Overview {#payouts_intro_overview} ================================== `Payouts` transfers funds from one account to another using a two-step model: * An *account funding transaction* (AFT) withdraws funds from a sender's account using standard credit card processing. * An *original credit transaction* (OCT) deposits funds into a recipient's account. An AFT and OCT are independent transactions, though an AFT usually precedes a corresponding OCT. In typical payment transactions, you initiate debits and credits to receive payments from cardholders for your goods and services. With `Payouts`, you provide a money transfer service by initiating AFT and OCT transactions that move funds between accounts: * A *business-to-person* payment moves funds between a merchant and a cardholder. * A *person-to-person* payment moves funds between two cardholders. No merchant goods are involved in `Payouts` transactions. At present, `FDC Nashville Global` supports AFT services only. You must receive prior approval from ` FDC Nashville Global ` before using the AFT services. Contact ` FDC Nashville Global ` to register in the AFT program. Supported Card Types {#payouts-intro-processor-cards} ===================================================== Recipient card type for AFTs: * Mastercard * Visa {#payouts-intro-processor-cards_ul_f5p_x3r_jdc} **Card types:** * Mastercard * Visa Currencies: CAD, GBP, and USD Requirements {#payouts-intro-requirements} ========================================== To use Payouts services, you must obtain approval from your acquirer for requesting this type of transaction. Account Funding Transactions {#payouts-services-intro} ====================================================== The Account Funding Transaction (AFT) enables the transfer of funds between a payment card and another account, including other payment cards. When used independently, an AFT can only transfer funds between accounts owned by the same person or business entity. An AFT is not intended to pay for goods and services, fund a merchant account, or repay debts. > You must receive approval from ` FDC Nashville Global ` before using the AFT services. Contact ` FDC Nashville Global ` to register in the AFT program. AFT Transaction Types --------------------- The Account Funding Transaction (AFT) is a specific type of transaction that moves funds from a Visa account to another Visa or non-Visa account. It is primarily used for: * Loading or topping up prepaid card accounts. * Transferring funds into another financial account, such as a savings account. * Acting as a funding source for person-to-person (P2P) money transfers. * Loading third-party digital wallets. You cannot use an AFT for purchasing goods or services or transferring funds to a merchant account. AFTs are the required transactions to load or top-up prepaid cards in all regions. An AFT is the required pull transaction to be used for disbursing payroll funds, P2P or me-to-me transactions, and pre-funding a customer's digital wallet in a card-not-present environment. When used independently to fund another Visa or non-Visa account, AFTs must be used only to fund an account belonging to the same individual or entity holding the Visa account. Reverse or Adjust AFT Transactions ---------------------------------- You can reverse an AFT within the first 24 hours of the original transaction before the transaction settles. You can refund an AFT back to the sender's card within 30 days of the original AFT. You cannot originate a refund if the original transaction is over 30 days old. The system accepts a refund after the original AFT settles. Issuers can manage AFT refunds as credit adjustments instead of posting the transaction directly into the cardholder's account. Therefore, the time-frame for when the cardholder should expect the refund will vary by issuer. Process a Dual Message AFT {#payouts-services-auth-dual-message-aft-intro} ========================================================================== Account Funding Transactions allow a payment service provider to debit funds from a cardholder's Mastercard or Visa account to fund a non-merchant account. This is typically used to load funds onto prepaid cards and electronic wallets. Dual Message Account Funding Transactions (AFTs) provide the following benefits: * Enables customers to identify Mastercard and Visa transactions during the authorization and settlement. * Allows acquiring partners to use Dual Message BINs when performing a payout transaction. Endpoint {#payouts-services-auth-dual-message-aft-intro_d7e16} -------------------------------------------------------------- Set the ccAuthService_run field to `true`. Send the request to `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor`. Required Fields for a Dual-Message AFT Request for `FDC Nashville Global` {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal} ======================================================================================================================================= These fields are required to process a dual-message AFT request: [aft_indicator](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/aft-indicator.md "") : [billTo_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-last-name.md "") : [billTo_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-country.md "") : [billTo_email](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-email.md "") : [billTo_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-first-name.md "") : [billTo_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-last-name.md "") : [billTo_phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-phone-number.md "") : [billTo_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-postal-code.md "") : [billTo_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-state.htm "") : [billTo_street1](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/bill-to-street1.md "") : [card_accountNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-account-number.md "") : [card_cardType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-card-type.md "") : [card_cvNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "") : [card_expirationMonth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-expiration-month.md "") : [card_expirationYear](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/card-expiration-year.md "") : [invoiceHeader_businessApplicationId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/invoice-header-business-application-id.md "") : These are the values when using a Mastercard card type: * `AA`: Account-to-account. * `BB`: Business to business. * `CO`: Cash out. * `CP`: Card bill payment. * `MD`: Merchant disbursement (acquirers or aggregators settling to merchants). * `PP`: Person to person. * `WT`: When AFT is used to fund a staged digital wallet. {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_ul_emx_dnw_zcc-so} : These are the values when a Visa card type: * `AA`: Account to account. * `BI`: Business to business. * `CB`: Consumer bill payment. * `FT`: Funds transfer. * `PP`: Person to person. * `TU`: Top Up: Prepaid load. * `WT`: Wallet transfer. {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_bai-value-fdiglobal-so} [merchantID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-id.md "") : [merchantReferenceCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/merchant-reference-code.md "") : [purchaseTotals_currency](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-currency.md "") : [purchaseTotals_grandTotalAmount](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/purchase-totals-grand-total-amount.md "") : [recipient_accountId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-account-id.md "") : Required with Mastercard. [recipient_accountType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-account-type.md "") : Required for Mastercard. These codes are permitted: * `00`: Other * `01`: Routing transit number (RTM) and bank account * `02`: IBAN * `03`: Card account * `04`: Email * `05`: Phone number * `06`: Bank account number (BAN) and Bank identification number code (BIC) * `07`: Wallet ID * `08`: Social network ID {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_ul_xtv_2vt_rdc} [recipient_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-country.md "") : Required with Mastercard for domestic funding transactions when the transaction is a subsequent and cross-border funds transfer. [recipient_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-first-name.md "") : Required with Mastercard. Required with Visa for intra-European Economic Area (EEA), including UK and Gibraltar, and EU international transactions. Optional with Visa for domestic EU AFTs. [recipient_phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-phone-number.md "") : [recipient_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-last-name.md "") : Required with Mastercard. Required with Visa for intra-European Economic Area (EEA), including UK and Gibraltar, and EU international transactions. Optional with Visa for domestic EU AFTs. [recipient_middleName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-middle-name.md "") : Required with Visa for intra-European Economic Area (EEA), including UK and Gibraltar, and EU international transactions. Optional with Visa for domestic EU AFTs and Mastercard. [recipient_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-postal-code.md "") : [sender_accountNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-account-number.md "") : Required with Visa in the EU. [sender_address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-address.md "") : Required with Visa transactions into and out of Canada with the address of the person or entity. Optional with Mastercard. [sender_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-city.md "") : Required with Visa transactions into and out of Canada for cross-border money and non-money transfers. Optional with Mastercard. [sender_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-country.md "") : Required with Visa transactions into and out of Canada. Optional with Mastercard. [sender_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-first-name.md "") : Required with Visa. Optional with Mastercard. [sender_identificationNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-id-number.md "") : Required with Visa EMV transactions. [sender_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-last-name.md "") : Required with Visa. Optional with Mastercard. [sender_middleName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-middle-name.md "") : Required with Visa. Optional with Mastercard. [sender_name](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-name.md "") : This field contains the sender business, government, non-government name, or Visa payer name. When this field is present in a transaction, the senderInformation.firstName, senderInformation.middleName, and senderInformation.lastName fields should not be present in the transaction. [sender_personalIdType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-personal-id-type.md "") : Strongly recommended with Visa. : These are the valid values: * `ARNB`: Alien registration number * `BTHD`: Date of birth * `CPNY`: Company registration number * `CUID`: Customer identification (unspecified) * `DRLN`: Driver license * `EMAL`: Email * `LAWE`: Law enforcement identification * `MILI`: Military identification * `NTID`: National identification * `PASN`: Passport number * `PHON`: Phone number * `PRXY`: Proxy identification * `SSNB`: Social security number * `TRVL`: Travel identification (non-passport) * `TXIN`: Tax identification {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_ul_hfk_1xt_rdc} [sender_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-state.md "") : Required with Visa for transactions in Canada and US. Optional with Mastercard. {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_dl_yyl_mhh_2cc} Optional Fields for a Dual-Message AFT {#payouts-services-auth-dual-message-aft-optfields-fdiglobal} ==================================================================================================== You can include these optional fields in an authorization request for an AFT: [authService_purposeOfPayment](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/oct-service-purpose-of-payment.md "") : [recipient_address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-address.md "") : [recipient_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-city.md "") : [recipient_middleName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-middle-name.md "") : [recipient_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-state.md "") : [sender_sourceOfFunds](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-source-of-funds.md "") : These are the valid values: * `01`: Credit (Visa or Mastercard credit card) * `02`: Debit (Visa or Mastercard debit card) * `03`: Prepaid (Visa or Mastercard prepaid card) * `04`: Deposit account (checking, savings, or cryptocurrency) * `06`: Cash {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_ul_dmf_nvt_rdc} [sender_accountType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-account-type.md "") : These are the valid values: * `00`: Other * `01`: Routing Transit Number (RTN) + Bank Account Number (BAN) * `02`: International Bank Account Number (IBAN) * `03`: Card Account * `04`: Email * `05`: Phone Number * `06`: Bank Account Number (BAN) + Bank Identification Code (BIC), also known as a SWIFT code * `07`: Wallet ID * `08`: Social Media ID {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_so-ul_dsx_vxn_pdc} [sender_dateOfBirth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-date-of-birth.md "") : [sender_phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-phone-number.md "") : [sender_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-postal-code.md "") : [sender_referenceNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-reference-number.md "") : [sender_type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-type.md "") : This field is optional, but strongly recommended. : These are the valid values: * `0B`: Business * `0I`: Individual {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_so_ul_mdk_5zm_rdc} Related Information {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_section_ant_bh2_rdc} ----------------------------------------------------------------------------------------------------- * [Simple Order API Field Reference Guide](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "") {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_ul_bnt_bh2_rdc} Simple Order Example: Dual-Message AFT for `FDC Nashville Global` {#payouts-services-auth-dual-message-aft-ex-so-fdiglobal} =========================================================================================================================== Request ``` <requestMessage xmlns="urn:schemas-cybersource-com:transaction-data-1.221"> <merchantID>en_vdcuruguay_1_ccs</merchantID> <merchantReferenceCode>TC55255-1</merchantReferenceCode> <invoiceHeader> <businessApplicationID>AA</businessApplicationID> </invoiceHeader> <billTo> <firstName>JHON</firstName> <lastName>SMITH</lastName> <street1>1-26-28 Nakashirane,</street1> <city>Yokohama-shi</city> <state>CA</state> <postalCode>602-8511</postalCode> <country>US</country> <phoneNumber>999-123-9999</phoneNumber> <email>test@visa.com</email> </billTo> <purchaseTotals> <currency>USD</currency> <grandTotalAmount>100</grandTotalAmount> <invoiceAmount>1234</invoiceAmount> </purchaseTotals> <card> <accountNumber>4111111111111111</accountNumber> <expirationMonth>12</expirationMonth> <expirationYear>2030</expirationYear> <cvNumber>123</cvNumber> <cardType>001</cardType> </card> <recipient> <postalCode>222120</postalCode> <accountID>987654321</accountID> <accountType>33</accountType> <lastName>last</lastName> <firstName>firstname</firstName> <middleName>middlename</middleName> <address>this is address1</address> <city>Newyork</city> <country>US</country> </recipient> <sender> <referenceNumber>REFNUM123</referenceNumber> <sourceOfFunds>02</sourceOfFunds> <name>justsenderName</name> <address>addressofthesender</address> <city>Newyork</city> <state>ca</state> <country>US</country> <accountNumber>154264765376576126571652675176</accountNumber> <firstName>Senderfirst</firstName> <middleName>SenderMiddle</middleName> <lastName>Senderlast</lastName> <personalIDType>TXIN</personalIDType> <type>B</type> <identificationNumber>23506907642323235</identificationNumber> </sender> <aft> <indicator>true</indicator> </aft> </requestMessage> ``` Response ``` <c:replyMessage xmlns:c="urn:schemas-cybersource-com:transaction-data-1.221"> <c:merchantReferenceCode>TC55255-1</c:merchantReferenceCode> <c:requestID>7193792686247001309916</c:requestID> <c:decision>ACCEPT</c:decision> <c:reasonCode>100</c:reasonCode> <c:requestToken>Axj/7wSThfntrctjncLcAHgs3YuWbdyybOGzJo3YMGLNg5csWybWNLQsAAU2saWhYBpA6cQQUYZNv/sXFU8Q64E5OF+e2ty2OdwtwAAA5xPu</c:requestToken> <c:purchaseTotals> <c:currency>USD</c:currency> </c:purchaseTotals> <c:ccAuthReply> <c:reasonCode>100</c:reasonCode> <c:amount>100.00</c:amount> <c:authorizationCode>831000</c:authorizationCode> <c:avsCode>Y</c:avsCode> <c:avsCodeRaw>Y</c:avsCodeRaw> <c:cvCode>M</c:cvCode> <c:cvCodeRaw>M</c:cvCodeRaw> <c:authorizedDateTime>2024-06-26T05:21:10Z</c:authorizedDateTime> <c:processorResponse>00</c:processorResponse> <c:reconciliationID>7193792686247001309916</c:reconciliationID> <c:merchantAdviceCode>01</c:merchantAdviceCode> <c:merchantAdviceCodeRaw>M001</c:merchantAdviceCodeRaw> <c:cavvResponseCode>2</c:cavvResponseCode> <c:cavvResponseCodeRaw>2</c:cavvResponseCodeRaw> <c:paymentNetworkTransactionID>016153570198200</c:paymentNetworkTransactionID> <c:reconciliationReferenceNumber>417805815972</c:reconciliationReferenceNumber> </c:ccAuthReply> <c:receiptNumber>815972</c:receiptNumber> <c:additionalData>ABC</c:additionalData> <c:card> <c:cardType>001</c:cardType> </c:card> <c:reserved> <ics_message xmlns="urn:schemas-cybersource-com:transaction-data:ics"> <ics_decision_reason_code>100</ics_decision_reason_code> <auth_payment_network_transaction_id>016153570198200</auth_payment_network_transaction_id> <auth_rcode>1</auth_rcode> <receipt_number>815972</receipt_number> <ics_return_code>1000000</ics_return_code> <auth_merchant_advice_code>01</auth_merchant_advice_code> <ics_rcode>1</ics_rcode> <auth_cavv_response_code>2</auth_cavv_response_code> <auth_auth_response>00</auth_auth_response> <auth_rmsg>Request was processed successfully.</auth_rmsg> <merchant_ref_number>TC55255-1</merchant_ref_number> <auth_merchant_advice_code_raw>M001</auth_merchant_advice_code_raw> <currency>USD</currency> <auth_auth_code>831000</auth_auth_code> <auth_auth_amount>100.00</auth_auth_amount> <auth_cv_result_raw>M</auth_cv_result_raw> <auth_fee_program_indicator>123</auth_fee_program_indicator> <card_type>001</card_type> <auth_additional_token_response_information>0</auth_additional_token_response_information> <ics_rmsg>Request was processed successfully.</ics_rmsg> <auth_trans_ref_no>7193792686247001309916</auth_trans_ref_no> <request_id>7193792686247001309916</request_id> <auth.reason_code>100</auth.reason_code> <auth_cavv_response_code_raw>2</auth_cavv_response_code_raw> <auth_auth_time>2024-06-26T052110Z</auth_auth_time> <auth_rflag>SOK</auth_rflag> <auth_cv_result>M</auth_cv_result> <auth_return_code>1010000</auth_return_code> <auth_avs_raw>Y</auth_avs_raw> <ics_rflag>SOK</ics_rflag> <auth_reconciliation_reference_number>417805815972</auth_reconciliation_reference_number> <auth_auth_avs>Y</auth_auth_avs> <request_token>Axj/7wSThfntrctjncLcAHgs3YuWbdyybOGzJo3YMGLNg5csWybWNLQsAAU2saWhYBpA6cQQUYZNv/sXFU8Q64E5OF+e2ty2OdwtwAAA5xPu</request_token> <additional_data>ABC</additional_data> </ics_message> </c:reserved> <c:additionalToken> <c:responseInformation>0</c:responseInformation> </c:additionalToken> </c:replyMessage> ``` Process a Dual Message AFT Reversal or Refund {#payouts-services-auth-dual-message-aft-intro} ============================================================================================= Account Funding Transaction reversals and refunds allow a payment service provider to return funds to a customer's account. A reversal returns funds before the transaction settles. You can process an AFT reversal within the first 24 hours after a transaction. A refund returns funds after the transaction settles. You can process a refund within 30 days of the original AFT transaction. Endpoint {#payouts-services-auth-dual-message-aft-intro_d7e16} -------------------------------------------------------------- Set the ccAuthService_run field to `true`. Send the request to `https://ics2ws.ic3.com/commerce/1.x/transactionProcessor`. Required Fields for a Dual-Message AFT Reversal or Refund for `FDC Nashville Global` {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal} ================================================================================================================================================== These fields are required to process a dual-message AFT reversal or refund: [invoiceHeader_businessApplicationId](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/invoice-header-business-application-id.md "") : These are the values when using a Mastercard card type: * `AA`: Account-to-account. * `BB`: Business to business. * `CO`: Cash out. * `CP`: Card bill payment. * `MD`: Merchant disbursement (acquirers or aggregators settling to merchants). * `PP`: Person to person. * `WT`: When AFT is used to fund a staged digital wallet. {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_ul_emx_dnw_zcc-so} : These are the values when a Visa card type: * `AA`: Account to account. * `BI`: Business to business. * `CB`: Consumer bill payment. * `FT`: Funds transfer. * `PP`: Person to person. * `TU`: Top Up: Prepaid load. * `WT`: Wallet transfer. {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_bai-value-fdiglobal-so} {#payouts-services-auth-dual-message-aft-reqfields-fdiglobal_dl_yyl_mhh_2cc} Optional Fields for a Dual-Message AFT Reversal or Refund {#payouts-services-auth-dual-message-aft-optfields-fdiglobal} ======================================================================================================================= You can include these optional fields in an authorization request for an AFT reversal or refund: [aft_foreignExchangeFee](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/aft-foreign-exchange-fee.md "") : This field is supported only for cross-border transactions. A cross-border transaction is a transaction for which the payment card is issued in one country and accepted by a merchant in another country. {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_dl_ygn_wjt_tgc} [aft_serviceFee](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/aft-service-fee.md "") : This field is supported only for cross-border transactions. A cross-border transaction is a transaction for which the payment card is issued in one country and accepted by a merchant in another country. [authService_purposeOfPayment](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/oct-service-purpose-of-payment.md "") : [invoiceHeader_merchantVATRegistrationNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/invoice-header-merchant-vat-reg-num.md "") : [recipient_accountID](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-account-id.md "") : [recipient_address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-address.md "") : [recipient_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-city.md "") : [recipient_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-country.md "") : [recipient_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-first-name.md "") : [recipient_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-last-name.md "") : [recipient_middleName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-middle-name.md "") : [recipient_phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-phone-number.md "") : [recipient_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-postal-code.md "") : [recipient_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/recipient-state.md "") : [sender_accountNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-account-number.md "") : [sender_accountType](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-account-type.md "") : These are the valid values: * `00`: Other * `01`: Routing Transit Number (RTN) + Bank Account Number (BAN) * `02`: International Bank Account Number (IBAN) * `03`: Card Account * `04`: Email * `05`: Phone Number * `06`: Bank Account Number (BAN) + Bank Identification Code (BIC), also known as a SWIFT code * `07`: Wallet ID * `08`: Social Media ID {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_so-ul_dsx_vxn_pdc} [sender_address](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-address.md "") : [sender_city](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-city.md "") : [sender_country](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-country.md "") : [sender_dateOfBirth](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-date-of-birth.md "") : [sender_firstName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-first-name.md "") : [sender_lastName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-last-name.md "") : [sender_middleName](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-middle-name.md "") : [sender_name](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-name.md "") : [sender_phoneNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-phone-number.md "") : [sender_postalCode](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-postal-code.md "") : [sender_referenceNumber](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-reference-number.md "") : [sender_sourceOfFunds](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-source-of-funds.md "") : These are the valid values: * `01`: Credit card. * `02`: Debit card. * `03`: Prepaid card. * `04`: Cash. * `05`: Debit or deposit account. Value `05` must be used when the processingInformation.businessApplicationId field is set to one of these values: `FD`, `GD`, `GP`, `LO`, `MD`, `OG`, `PD`. * `06`: Visa card transactions only. Credit accounts not linked to a Visa card. * `07`: Mastercard only. {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_ul_lw3_klt_tgc} [sender_state](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-state.md "") : [sender_type](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/sender-type.md "") : This field is optional, but strongly recommended. : These are the valid values: * `B`: Business * `I`: Individual {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_so_ul_mdk_5zm_rdc} Related Information {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_section_ant_bh2_rdc} ----------------------------------------------------------------------------------------------------- * [Simple Order API Field Reference Guide](https://developer.cybersource.com/docs/cybs/en-us/api-fields/reference/all/so/api-fields/api-fields-so-intro.md "") {#payouts-services-auth-dual-message-aft-optfields-fdiglobal_ul_bnt_bh2_rdc} Business Application Identifier Values {#payouts-appendix-bai} ============================================================== The Business Application Identifier (BAI) is used to identify the category of the Account Funding Transaction (AFT). Provide one of the values when you send field `invoiceHeader_businessApplicationID`. All acquirers, service providers, and merchants are required to submit a valid BAI value when submitting AFTs. > Ensure your acquirer has a Merchant Category Code (MCC) that aligns with the BAI values you are using. For more information, contact your acquirer. | BAI Value | Category | Requirements | |:----------|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `AA` | Account-to-Account Money Transfer. The funding of the cardholder's own account at the same or a different financial institution Both accounts must be owned by the same person/entity. | > If funding a prepaid account, don't use this value, use ` TU `. | | `BB` | Business to Business | | | `BI` | Financial Institution offered Bank-Initiated P2P Money Transfer | P2P Money Transfer is initiated from an online banking system, making it a bank-initiated transaction. This category is only used for specific scenarios and only available in limited markets. For more information, contact your Visa representative. This value is only available with Visa card types. | | `CB` | Consumer Bill Payment | This value is only available with Visa card types. | | `CO` | Cash Out | | | `CP` | Cash Bill Payment | | | `FD` | Funds Disbursement | Available only with Visa card transactions. | | `FT` | Funds Transfer | If the funds will be used for a high-brand risk transaction, the applicable high-brand risk MCC must be used. If a wallet is used to purchase Liquid and Cryptocurrency assets, the applicable special condition indicator must be used. This value is only available with Visa card types. | | `GD` | Government disbursement, including: * Government-initiated tax refunds * Government benefit and welfare disbursements {#payouts-appendix-bai_ul_lzj_1vn_pdc} | This value is only available with Visa card types. | | `GP` | Gambling payout other than online gambling. | This value is only available with Visa card types. | | `LO` | Loyalty credits and rebates (not supported in European systems). | This value is only available with Visa card types. | | `NA` | Merchant instant funding. | This value is only available with Visa card types. | | `MI` | Merchant-initiated money transfer. | This value is only available with Visa card types. | | `MD` | Merchant disbursement (acquirers or aggregators settling to merchants). | | | `PD` | Payroll Disbursement | This value is only available with Visa card types. | | `PP` | Person-to-Person (P2P) Money Transfer | P2P Money Transfer is initiated from an online banking system, making it a bank-initiated transaction. This category is only used when both AFTs and OCTs are supported. When only AFT is supported, use the **FT** category. | | `TU` | Prepaid Card Load or Top-Up | This value is only available with Visa card types. | | `WT` | Staged Digital Wallet (SDW) Transfer | If the funds will be used for a high-brand risk transaction, the applicable high-brand risk MCC must be used. If the funds are used for a gambling transaction, the applicable gambling MCC must be used. If a wallet is used to purchase Liquid and Cryptocurrency assets, the applicable special condition indicator must be used. An AFT is not intended for debt repayment. | [Business Application Identifier Values] Recipient Account {#payouts-appendix-receiver-account} ====================================================== The Sender Source identifies the source of funds. Provide one of the values when you send field `recipient_accountType`. | Value | Definition | |:------|:-------------------------------------------------------------| | `00` | Other | | `01` | RNT and Bank Account | | `02` | IBAN | | `03` | Card Account | | `04` | Email | | `05` | Phone Number | | `06` | Bank account number (BAN) and Bank Identification Code (BIC) | | `07` | Wallet ID | | `08` | Social Network ID | [Recipient Account Values] Sender Source {#payouts-appendix-sender-source} =============================================== The Sender Source identifies the source of funds. Provide one of the values when you send field `sender_sourceOfFunds`. All acquirers, service providers, and merchants are required to submit a valid sender source value when submitting AFTs. | Value | Definition | |:------|:----------------| | `01` | Credit Card | | `02` | Debit Card | | `03` | Prepaid Card | | `04` | Deposit Account | | `06` | Cash | [Sender Source Values] Reference Information {#payouts-ref-intro} ========================================== This section provides helpful reference information for using `Payouts` services. Business Application Identifier {#payouts-appendix-bai} ======================================================= The Business Application Identifier (BAI) identifies the category of the Account Funding Transaction (AFT). All acquirers, service providers, and merchants must submit a valid BAI value when submitting an AFT. Provide one of the values when you send field `invoiceHeader_businessApplicationID`. > Ensure that your acquirer has a Merchant Category Code (MCC) that corresponds with the BAI value you are using. For more information, contact your acquirer. | BAI Value | Category | Requirements | |:----------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `AA` | Account-to-Account Money transfer. This value is for funding the cardholder's own account at the same or a different financial institution. Both accounts must be owned by the same person or entity. | > If funding a prepaid account, do not use this value. Use ` TU ` instead. This value is only available with Visa card types. | | `BB` | Business-to-Business | | | `BI` | Financial Institution offered Bank-Initiated P2P Money Transfer | P2P Money transfer is started from an online banking system, making it a bank-initiated transaction. This category is only used for specific scenarios and is only available in limited markets. For more information, contact your Visa representative. This value is only available with Visa card types. | | `CO` | Cash Out | | | `CP` | Cash Bill Payment | | | `FD` | Funds Disbursement | Available only with Visa card transactions. | | `FT` | Funds Transfer | If the funds will be used for a high-brand risk transaction, the applicable high-brand risk MCC must be used. If a wallet is used to purchase Liquid and Cryptocurrency assets, the applicable special condition indicator must be used. This value is only available with Visa card types. | | `GD` | Government disbursement, including: * Government-initiated tax refunds * Government benefit and welfare disbursements {#payouts-appendix-bai_ul_lzj_1vn_pdc} | This value is only available with Visa card types. | | `GP` | Gambling payout other than online gambling. | This value is only available with Visa card types. | | `LO` | Loyalty credits and rebates (not supported in European systems). | This value is only available with Visa card types. | | `MD` | Merchant disbursement (acquirers or aggregators settling to merchants). | | | `MI` | Merchant-initiated money transfer. | This value is only available with Visa card types. | | `OG` | Online Gambling payout | This value is only available with Visa card types. | | `PD` | Payroll Disbursement | This value is only available with Visa card types. | | `PP` | Person-to-Person (P2P) Money Transfer | P2P Money transfer is started from an online banking system, making it a bank-initiated transaction. This category is only used when both AFTs and OCTs are supported. When only AFT is supported, use the `FT` category. | | `TU` | Prepaid Card Load or Top-Up | This value is only available with Visa card types. | | `WT` | Staged Digital Wallet (SDW) Transfer | If the funds will be used for a high-brand risk transaction, the applicable high-brand risk MCC must be used. If the funds are used for a gambling transaction, the applicable gambling MCC must be used. If a wallet is used to purchase Liquid and Cryptocurrency assets, the applicable special condition indicator must be used. An AFT is not intended for debt repayment. | [Business Application Identifier Values] Recipient Account {#payouts-appendix-receiver-account} ====================================================== The Sender Source field identifies the source of funds. Provide one of the values when you send field `recipient_accountType`. | Value | Definition | |:------|:-------------------------------------------------------------| | `00` | Other | | `01` | RNT and Bank Account | | `02` | IBAN | | `03` | Card Account | | `04` | Email | | `05` | Phone Number | | `06` | Bank account number (BAN) and Bank Identification Code (BIC) | | `07` | Wallet ID | | `08` | Social Network ID | [Recipient Account Values] Sender Source {#payouts-appendix-sender-source} =============================================== The Sender Source field identifies the source of funds. Provide one of the values when you send field `sender_sourceOfFunds`. All acquirers, service providers, and merchants are required to submit a valid sender source value when submitting an AFT. | Value | Definition | |:------|:----------------| | `01` | Credit card | | `02` | Debit card | | `03` | Prepaid card | | `04` | Deposit account | | `06` | Cash | [Sender Source Values]