API Changelog - 2026-08-05: Summary
Account Funding Transaction (AFT) support is now publicly documented for
Mastercard and Maestro payment methods. A new fundsTransfer field has been
added to the request body of card payment endpoints and to their corresponding
payment detail responses for Mastercard/Maestro.
POST /v1/payments — Create Payment (Mastercard / Maestro)
The paymentMethod.fundsTransfer field has been added to the Mastercard and
Maestro payment method request objects. Use this field to supply Account
Funding Transaction (AFT) details when initiating a funds transfer via card.
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer |
| Location | Request body |
| Type | object |
| Required | No (optional) |
| Format | Funds transfer object — see sub-fields below |
| Example | { "type": "own_account", "sender": {...}, ... } |
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer.type |
| Location | Request body |
| Type | string |
| Required | Yes (when fundsTransfer is present) |
| Format | Enum — e.g. own_account, wallet_crypto |
| Example | "own_account" |
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer.sender.name |
| Location | Request body |
| Type | string |
| Required | Yes (when fundsTransfer is present) |
| Format | Max 35 characters |
| Example | "John" |
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer.sender.surname |
| Location | Request body |
| Type | string |
| Required | Yes (when fundsTransfer is present) |
| Format | Max 35 characters |
| Example | "Doe" |
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer.sender.address.country |
| Location | Request body |
| Type | string |
| Required | Yes (when sender.address is present) |
| Format | 2-character country code (ISO 3166-1 alpha-2) |
| Example | "DE" |
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer.sender.address.state |
| Location | Request body |
| Type | string |
| Required | Required for us/ca; omit for other countries |
| Format | ISO 3166-2 subdivision code, 1–3 characters |
| Example | "CA" |
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer.recipient.account.type |
| Location | Request body |
| Type | string |
| Required | Yes (when recipient.account is present) |
| Format | Enum — e.g. wallet |
| Example | "wallet" |
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer.recipient.account.wallet.reference |
| Location | Request body |
| Type | string |
| Required | Yes (when account type is wallet) |
| Format | Max 34 characters |
| Example | "wallet-ref-001" |
GET /v1/payments/{paymentId} — Get Payment Detail (Mastercard / Maestro)
The fundsTransfer field is now returned in the payment detail response for
Mastercard and Maestro payments when the original payment included AFT data.
| Property | Details |
|---|
| Name | paymentMethod.fundsTransfer |
| Location | Response body |
| Type | object |
| Required | No (present only when AFT data was submitted) |
| Format | Funds transfer details object |
| Example | { "type": "own_account", "sender": {...}, ... } |