Single Transfers
To authorize a single transfer, you will need to send a request to the endpoint below:
Info |
---|
This endpoint is protected with OAuth 2.0 Bearer token |
Endpoint
...
URL: {{base_url}}/api/v2/disbursements/single/validate-otp
Both endpoints are protected with OAuth 2.0 Bearer TokenHTTP Method: POST
Info |
---|
The {{base_url}} for test is |
Below is a sample request for authorizing a transfer
...
Authorize Transfer Request (Single)
Code Block | ||
---|---|---|
| ||
{ "reference":"reference12934", "authorizationCode":"40538652" } |
If the merchant does not have Two Factor Authentication (2FA) enabled, the transaction will be processed instantly and the response will be as follows:
...
...
Authorize Transfer Response (Single)
Code Block | ||
---|---|---|
| ||
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "amount": 10, "reference": "reference12934", "status": "SUCCESS", "dateCreated": "13/11/2019 09:34:32 PM" } } |
...
Bulk Transfers
To authorize a bulk transfer, you will need to send a request to the endpoint below:
...
Endpoint
...
URL:{{base_url}}/api/v2/disbursements/batch/validate-otp
...
Both endpoints are protected with Basic Authentication
HTTP Method: POST
Info |
---|
This endpoint is protected with OAuth 2.0 Bearer token |
Below is a sample request for authorizing a transfer
...
Authorize Transfer Request (Bulk)
Code Block | ||
---|---|---|
| ||
{ "reference":"batch-reference12934", "authorizationCode":"40538652" } | ||
Code Block | ||
language | js | |
theme | Midnight | title |
Authorize Transfer Response (Bulk)
Code Block | ||
---|---|---|
| ||
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "totalAmount": 2108.48, "totalFee": 8.48, "batchReference": "batch-reference12934", "batchStatus": "AWAITING_PROCESSING", "totalTransactions": 3, "dateCreated": "13/11/2019 10:45:08 PM" } } |
...
Field Reference
(M) indicates fields that are mandatory in the request body. (m) Indicates Indicates fields that are mandatory only if the parent object is not empty.
Field | Description |
---|---|
authorizationCode (M) | The One Time Password sent to the specified email to be used to authenticate the transaction |
reference (M) | The unique reference for a transaction. Also to be specified for each transaction in a bulk transaction request. |
amount (M) | The amount to be disbursed to the beneficiary |
batchReference (M) | The unique reference for the entire batch of transactions being sent. |
totalAmount | The total amount deducted for all the transactions in the batch |
totalFee | The total transaction fees deducted for all the transactions in the batch. |
status | The status of a single transfer request. (SUCCESS, FAILED, PENDING, OTP_EMAIL_DISPATCH_FAILED, PENDING_AUTHORIZATION) |
batchStatus | The status of the processing of the entire Batch. (FAILED_ON_ACCOUNTS_VALIDATION, OTP_EMAIL_DISPATCH_FAILED, PENDING, PENDING_AUTHORIZATION, AWAITING_PROCESSING, IN_PROGRESS ,COMPLETED) |
totalTransactions | The total number of transactions in the batch. |
Related Articles
Filter by label (Content by label) | ||||||
---|---|---|---|---|---|---|
|