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.

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

Browser not supported