Account Funding Transactions
This section is applicable for Visa and Mastercard only.
A funding transaction is for funds transfer from an eligible account by an acquirer on behalf of the customer (referred to in this Guide as the ‘sender’), for the purpose of either: (a) funding a subsequent and linked funds transfer from the sender to another person or entity (referred to in this Guide as the ‘recipient’; or (b) transferring funds into another eligible financial account held by that sender. If your payment service provider has enabled Account Funding Transactions (AFT) functionality for you, you can facilitate the following Account Funding Transaction types for your senders:
- Person-to-Person funds transfers
- Intra-organizational funds transfers
- Inter-organizational funds transfers
Supported methods and operations
| Integration methods | Payment methods | Transactions |
|---|---|---|
| All | Credit and debit cards (Mastercard & Visa) |
|
To view an example of an API request with AFT data, download the Postman collection.
The Mastercard AFT support is available from API version 65 onwards.
The Visa AFT support is available from API version 80 onwards.
The following API operations support AFT transactions from API version 80 onwards:
- Authenticate Payer
- Update Session
- Initiate Checkout
For merchants processing Mastercard card transactions, the Mastercard MoneySend and Funding Transactions Program applies only to the merchants with the following Merchant Category Codes (MCC):
- 4829 (Money transfer)
- 6540 (Funding transactions)
- 6538 (Funding transactions for MoneySend)
For merchants processing Visa card transactions, the Visa Account Funding Transaction applies only to the merchants with the following Merchant Category Codes (MCC):
- 4829 (Money transfer)
- 6540 or 6051 (Funding transactions)
- 6012 (Financial institutions)
AFT data includes information about:
- Sender type
- Sender name & address details
- Funding purpose
- Recipient name & address details
- Recipient type
- Recipient account identification type
- Account funding method
When you are required to submit AFT data, depending on the type of transaction you are submitting, you must provide some or all of the following transaction data in the request.
Account Funding Transaction request fields
| Field name | Description | Valid values |
|---|---|---|
accountFunding.purpose |
Purpose of account funding payment |
|
accountFunding.senderIsRecipient |
Sender is recipient flag. | - |
accountFunding.senderType |
Sender type |
|
accountFunding.recipient.account.fundingMethod |
Recipient’s account type |
|
accountFunding.recipient.account.identifier |
Recipient’s Payment account identifier | - |
accountFunding.recipient.account.identifierType |
Recipient’s account type Identifier |
|
accountFunding.recipient.address.city |
Recipient’s city | - |
accountFunding.recipient.address.country |
Recipient’s country | - |
accountFunding.recipient.address.postCodeZip |
Recipient’s address zip code | - |
accountFunding.recipient.address.stateProvinceCode |
Recipient’s state province code | - |
accountFunding.recipient.address.street |
Recipient’s first line of address | - |
accountFunding.recipient.address.street2 |
Recipient’s second line of address | - |
accountFunding.recipient.firstName |
Recipient’s first name | - |
accountFunding.recipient.middleName |
Recipient’s middle name | - |
accountFunding.recipient.lastName |
Recipient’s last name | - |
accountFunding.recipient.identification.country |
Recipient’s Identification Issuing country | - |
accountFunding.recipient.identification.type |
Recipient’s Identification Type |
|
accountFunding.recipient.identification.value |
Recipient’s Identification Number | - |
customer.firstName |
Senders’ First Name | - |
customer.middleName |
Senders’ Middle name | - |
customer.lastName |
Senders’ Last Name | - |
customer.identification.country |
Senders’ Identification country | - |
customer.identification.type |
Sender’s Identification type |
|
customer.identification.type |
Sender’s Identification type |
|
customer.identification.value |
Sender’s Identification value | - |
billing.address.street |
Sender’s address | - |
billing.address.city |
Sender’s city | - |
billing.address.country |
Sender’s country | - |
billing.stateProvinceCode |
Sender’s state province code | - |
For API version 79 and earlier, use the Authorize Request for Account Funding API version 79 request instead of Authorize Request for Account Funding API version 80.
Provide the sender’s details for all Visa AFT transaction requests.
Provide both the sender’s and recipient’s details for cross-border Visa AFT transaction requests.
For Visa AFT transactions, see the following scenarios for BAI mapping for supported MCCs.
| Business Application Identifier | MCC 4829 | MCC 6051 | MCC 6540 | MCC 6012 | WS-API request with fields in Auth/Pay operations |
|---|---|---|---|---|---|
| Transfers Initiated by Consumers to others | |||||
| General person to person – Other than CARD | FT | N/A | FT | FT |
|
| General person to person - CARD | PP | N/A | - | PP |
|
| General person to person – Staged wallet | - | WT | - | - |
|
| General person to person – Prepaid card | - | TU | TU | TU |
|
| Transfers Initiated by Consumer to self | |||||
| Transfer to Own card – Debit, Credit or charge | AA | - | - | AA |
|
| Transfer to Own card – Prepaid | - | TU | TU | TU |
|
| Transfer to Own Staged Digital Wallet Account | - | WT | - | - |
|
| Transfer to Own Stored value wallet account | FT | - | FT | FT |
|
| General Transfer to Own Account | FT | - | FT | FT |
|
| Transfers Initiated by Organizations to others | |||||
| Business Disbursement- OTHER than CARD | FT | - | FT | FT |
|
| Business Disbursement – Staged wallet | - | WT | - | - |
|
For Mastercard AFT transaction, see the following scenarios for Transaction Type Identifier mapping for supported MCCs.
| Transaction Type Identifier | MCC 4829 | MCC 6538 | MCC 6540 | API request with fields in Auth/Pay operations |
|---|---|---|---|---|
| Transfers Initiated by Consumers | ||||
| General person to person Transfer | Valid for F07 | Valid for C07 | Valid for F07 |
F07:
C07:
|
| Person to person – Transfer to Card Account | Valid for F08 | - | - |
|
| Transfers Initiated by Consumers or Organizations | ||||
| Transfer to Own Debit or prepaid account | Valid for F64 | - | - |
|
| Payment of Own Credit Card Bill | Valid for F54 | Valid for C54 | - |
C54:
F54:
|
| Transfer to Own Staged Digital Wallet Account | Valid for F61 | - | Valid for F61 |
|
| General Transfer to Own Account | Valid for F52 | Valid for C52 | - |
F52:
C52:
|
| Transfers Initiated by Organizations | ||||
| Business Disbursement | Valid for F55 | Valid for C55 | - |
F55:
C55:
|
| Government/Non- Profit Disbursement | - | Valid for C56 | - |
|
| Rapid Merchant Settlement | - | Valid for C57 | - |
|
| General Business to Business Transfer | Valid for F65 | Valid for C65 | - |
F65:
C65:
|
For more details, see the Mastercard MoneySend and Funding Transaction Program Standard specifications.
To process the AFT transaction through the gateway, you must submit the transaction with order.purchaseType = ACCOUNT_FUNDING. In addition, your request must include the MCC you are using for the transaction (order.merchantCategoryCode), else the default MCC configured on your merchant profile will apply. The submitted data is returned in the transaction response.
Example of AFT fields
{
"order": {
"purchaseType": "ACCOUNT_FUNDING",
"merchantCategoryCode": "4829"
},
"accountFunding": {
"recipient": {
"account": {
"identifier": "4797352254321089",
"identifierType": "CARD_NUMBER",
"fundingMethod": "UNKNOWN"
},
"firstName": "User",
"middleName": "John",
"lastName": "Duo",
"address": {
"street": "Street NJ",
"street2": "Times Square",
"city": "London",
"postCodeZip": "00312",
"stateProvinceCode": "LON",
"country": "GBR"
},
"identification": {
"type": "EMAIL",
"value": "abc12345@email.com",
"country": "AUS"
}
},
"senderIsRecipient": true,
"senderType": "PERSON",
"purpose": "OTHER"
},
"customer": {
"firstName": "Steven",
"middleName": "M",
"lastName": "Smith",
"identification": {
"type": "INDIVIDUAL_TAX_ID",
"value": "12345abcdef6789",
"country": "AUS"
}
}
}