Request Settlement/Payout to Beneficiary

Request body details for initiating a settlement or payout to a beneficiary.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

A unique identifier assigned by the merchant/client platform for every API request.

string
required

A unique identifier assigned by Decentro during onboarding.

string
required

The unique reference number for the target beneficiary. Received from Decentro in the Create Beneficiary Profile API response

string

Conditional Mandatory: The unique reference number for the target payment address. Received from Decentro in the Map Payment Address API response. This value is only mandatory when there is no default payment address mapped to a beneficiary or if you want to transfer funds to a specific payment address.

string

Conditional Mandatory: The Virtual Account number is mandatory only when the beneficiary was not mapped to a specific VA during the beneficiary creation process. If the beneficiary was mapped to a VA during the creation process, Decentro will debit the funds from that VA.

string
required

The transfer amount, up to 2 decimal places. The source currency will always be defined by the currency of the virtual account utilised for the settlement/payour

string
required

Text field which can be used for narrating the purpose of the fund transfer. Min length: 5 characters, Max length: 50 characters. Only alphanumeric characters are allowed.

Headers
string
required

The client identifier assigned by Decentro during onboarding.

string
required

The authorisation secret assigned by Decentro during onboarding.

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json