Payouts

Decentro’s Direct Payout stack facilitates all the requirements for performing payouts.

Decentro’s Direct Payout APIs consist of the following APIs:

Manage Beneficiaries: This API lets you add a beneficiary against your virtual account to perform a payout to the added beneficiary.

Get Beneficiary Details: This API lets you view all the beneficiaries that you have created against a virtual account.

Initiate Payout:This API lets you perform a payout from your virtual account to a beneficiary. The payout can be made to a registered or non-registered beneficiary.

Get Transaction Status:This API lets you check the status of a transaction. It is an alternative to the transaction status callback.

Batch Payout (JSON):This API lets you perform multiple payouts in a single request. The multiple transaction details will be provided in JSON format.

Batch Payout (CSV):This API lets you perform multiple payouts in a single request. The multiple transaction details will be provided in CSV format.

Batch Get Transaction Status: This API lets you check the status of all transactions initiated in the Batch Payout API request.


Transaction Status Mapping

To differentiate between API status and transaction status, Decentro provides a parameter called Transaction Status. This parameter must be used to map the status of the transaction. Below are the possible transaction status values:

  • Success: Indicates that the transaction was successfully processed.
  • Failure: Indicates that the transaction failed and the reversal of the amount has occurred.
  • Pending: Indicates that the transaction has been accepted for processing, but the final status is not yet available.
  • Unknown: Indicates that the transaction status is unavailable, as Decentro has not checked the status with the provider.