Dual Message Account Funding Transactions (AFTs)

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

Production:
POST
https://api.cybersource.com
/pts/v2/payments
Test:
POST
https://apitest.cybersource.com
/pts/v2/payments

Required Fields for a Dual-Message AFT Request for
FDC Nashville Global

These fields are required to process a dual-message AFT request:
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.
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.
Required with Mastercard.
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
Required with Mastercard for domestic funding transactions when the transaction is a subsequent and cross-border funds transfer.
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.
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.
Required with Visa for intra-European Economic Area (EEA), including UK and Gibraltar, and EU international transactions. Optional for domestic EU AFTs and Mastercard.
Required with Visa in the EU.
Required with Visa transactions into and out of Canada with the address of the person or entity. Optional with Mastercard.
Required with Visa for transactions in Canada and US. Optional with Mastercard.
Required with Visa transactions into and out of Canada. Optional with Mastercard.
Required with Visa. Optional with Mastercard.
Required with Visa EMV transactions.
Required with Visa. Optional with Mastercard.
Required with Visa transactions into and out of Canada for cross-border money and non-money transfers. Optional with Mastercard.
Required with Visa. Optional with Mastercard.
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.
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

Related Information

Optional Fields for a Dual-Message AFT

You can include these optional fields in an authorization request for an AFT:
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
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
This field is optional, but strongly recommended.
These are the valid values:
  • 0B
    : Business
  • 0I
    : Individual

Related Information

REST Example: Dual-Message AFT for
FDC Nashville Global

Light Dark
Request
1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950
{
  "clientReferenceInformation": {
    "code": "RTS-AFT3-8"
  },
  "processingInformation": {
    "capture": true,
    "businessApplicationId": "AA",
    "authorizationOptions": {
      "aftIndicator": true
    }
  },
  "paymentInformation": {
    "card": {
      "number": "453979100173XXXX",
      "expirationMonth": "03",
      "expirationYear": "2025",
      "type": "001",
      "securityCode": "351"
    }
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "28.00",
      "currency": "GBP"
    },
    "billTo": {
      "firstName": "Joe",
      "lastName": "Root",
      "middleName": "S",
      "address1": "34 Orchard Grove",
      "locality": "Southampton",
      "postalCode": "DE6 1BE",
      "country": "UK"
    }
  },
  "senderInformation": {
    "firstName": "Joe",
    "lastName": "Root",
    "middleName": "S",
    "address1": "34 Orchard Grove",
    "locality": "Southampton",
    "countryCode": "UK"
  },
  "recipientInformation": {
    "accountId": "4929421234600821",
    "firstName": "Ben",
    "lastName": "Stokes",
    "middleName": "A"
  }
}
Response
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455
{
  "_links": {
    "void": {
      "method": "POST",
      "href": "/pts/v2/payments/7286014246196696003955/voids"
    },
    "self": {
      "method": "GET",
      "href": "/pts/v2/payments/7286014246196696003955"
    }
  },
  "clientReferenceInformation": {
    "code": "RTS-AFT3-8"
  },
  "id": "7286014246196696003955",
  "issuerInformation": {
    "responseRaw": "0110322000000E10000200000000000000280010102303440139615736554359323159524D50353833313030303030000159004400223134573031363135303730333830323039344730363400103232415050524F56414C0006564943524320"
  },
  "orderInformation": {
    "amountDetails": {
      "totalAmount": "28.00",
      "authorizedAmount": "28.00",
      "currency": "GBP"
    }
  },
  "paymentAccountInformation": {
    "card": {
      "type": "001"
    }
  },
  "paymentInformation": {
    "tokenizedCard": {
      "type": "001"
    },
    "card": {
      "type": "001"
    }
  },
  "pointOfSaleInformation": {
    "terminalId": "01411543"
  },
  "processorInformation": {
    "merchantNumber": "000846649116882",
    "approvalCode": "831000",
    "networkTransactionId": "016150703802094",
    "transactionId": "016150703802094",
    "responseCode": "00",
    "avs": {
      "code": "Y",
      "codeRaw": "Y"
    }
  },
  "reconciliationId": "79576757",
  "status": "AUTHORIZED",
  "submitTimeUtc": "2024-10-10T23:03:44Z"}