Authorize Transfer (Deprecated)

Owned by Tobi Amira
Last updated: Aug 05, 2020 by Damilare Ogunnaike
2 min read

Single Transfers

To authorize a single transfer, you will need to send a request to the endpoint below:

Endpoint

POST: http://sandbox.monnify.com/api/v1/disbursements/single/validate-otp

Both endpoints are protected with Basic Authentication


Below is a sample request for authorizing a transfer

Authorize Transfer Request (Single)
{
    "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)
{
    "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

POST: http://sandbox.monnify.com/api/v1/disbursements/batch/validate-otp

Both endpoints are protected with Basic Authentication

Below is a sample request for authorizing a transfer

Authorize Transfer Request (Bulk) 
{
    "reference":"batch-reference12934",
    "authorizationCode":"40538652"
}
Authorize Transfer Response (Bulk) 
{
    "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 fields that are mandatory only if the parent object is not empty.

FieldDescription
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.
totalAmountThe total amount deducted for all the transactions in the batch
totalFeeThe total transaction fees deducted for all the transactions in the batch.
statusThe status  of a single transfer request. (SUCCESS, FAILED, PENDING, OTP_EMAIL_DISPATCH_FAILED, PENDING_AUTHORIZATION)
batchStatusThe status of the processing of the entire Batch. (FAILED_ON_ACCOUNTS_VALIDATION, OTP_EMAIL_DISPATCH_FAILED, PENDING, PENDING_AUTHORIZATION, AWAITING_PROCESSING, IN_PROGRESS ,COMPLETED)
totalTransactionsThe total number of transactions in the batch.