Skip to main content

BatchTransferItem

A single transfer within a batch (request payload). Omit currencyCode when it matches the batch default (batch-level currencyCode on create, or the batch's currency when using POST .../batch-transfers/{batchTransferId}/transfers). CSV uploads include a currency column per row.

amountinteger<int64>required

Transaction amount in minor units.

Example: 1000
currencyCodeCurrency (string)

Currency alphabetic code as specified by ISO 4217

Possible values: >= 3 characters and <= 3 characters

Example: EUR
recipient objectrequired

Contains transfer recipient information. If used in CustomerTransferRequest context, the system tries to resolve email or mobile to customerId in the system.

customerIdstring

Wallet customer identifier.

fullNamestring
Example: Jon Doe
emailstring<email>

Possible values: <= 150 characters

mobilestring

Mobile number

Possible values: <= 50 characters, Value must match regular expression ^\+\d+\s?\d{1,16}$

Example: +12025550120
merchantRefNumstring

Merchant reference number associated with the transfer. Auto-generated if not provided.

Possible values: <= 50 characters

Example: 5040452805
BatchTransferItem
{
  "amount": 1000,
  "currencyCode": "EUR",
  "recipient": {
    "customerId": "string",
    "fullName": "Jon Doe",
    "email": "user@example.com",
    "mobile": "+12025550120"
  },
  "merchantRefNum": "5040452805"
}