Transfers

In order to make successful transfer requests, you need to add the beneficiary beforehand.

It is essential to read the guide on adding beneficiaries as the requirements vary depending on the country/currency.

It is important to note that payout can only be initiated to a beneficiary whose status is SUCCESS .

After adding the beneficiary, we index the beneficiary and return a webhook beneficiary.status.changed

📘 Beneficiary status After adding a beneficiary, the beneficiary status

can be any of the following: md filename="Text" PENDING PROCESSING SUCCESS FAILED

In addition to the required fields in the destination object for creating beneficiaries per country, the following fields are also required irrespective of the destination country - reference, callbackUrl, country, and currency.

Parameter	Description	Required
`reference`	A reference to be used in identifying the beneficiary, must be unique for each beneficiary	✅
`callbackUrl`	Url to send event updates to	✅
`country`	Country of the beneficiary	✅
`currency`	Currency of the beneficiary	✅
`customerEmail`	Email of the customer creating beneficiary	❌
`destination`	Details of the beneficiary. This differs based on the country	✅

NOTE: While creating a beneficiary on sandbox environment,

If you want the beneficiary creation to fail, ensure that the last 6 digits of the beneficiary's account number ends with 1 (e.g 1425111111)
If you want to create a payout that will fail, ensure that the last 6 digits of the beneficiary account number ends with 0 (e.g 1425000000).

Settlement & cut-off times (USD channels)

Cut-off / processing

Channel	Cut-off / Processing
SWIFT	T + 3 days settlement
ACH	T + 1-3 days settlement
WIRE	Processed within US work hours (EST). 9am - 5pm — we advise sending by at least 4pm to avoid delays

Settlement timelines (USD channels)

Channel	Settlement timeline
ACH	T + 1-3 days settlement
SWIFT	T + 3 days settlement

Validation rules for payouts

WIRE & ACH: account number length must be at least 5 characters; routing number length must be exactly 9 digits.
SWIFT: SWIFT/BIC code must be between 8 and 11 characters long.

Customers