Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To reserve an account on Monnify, you’ll need to call the reserve account endpoint providing the information in the table below (remember to also add the authentication header)

...

Info
titleEndpoint
POST: https://sandbox.monnify.com/api/v1/bank-transfer/reserved-accounts/limit

This endpoint is protected with OAuth 2.0 (Bearer Tokens)

...

Code Block
languagejs
themeMidnight
titleReserve Account with Limit Response
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": {
        "contractCode": "797854529434915483727511",
        "accountReference": "abc123ref-007",
        "accountName": "TestKan Yo' Reserved with Limit Account",
        "currencyCode": "NGN",
        "customerEmail": "test@testerKanYo@monnify.com",
        "customerName": "Kan Yo",
        "accountNumber": "99009105659907335053",
        "bankName": "Providus Bank",
        "bankCode": "101",
        "reservationReference": "E9Y49CFNYAVHFGSCKJ6NQSD79W83J766XMFYM58L",
        "status": "ACTIVE",
        "createdOn": "2019-0810-1129 2313:0059:4337.816983",
        "incomeSplitConfig": [
            {
                "subAccountCode": "MFY_SUB_319452883228",
                "feePercentage": 10.5,
                "feeBearer": true,
                "splitPercentage": 20
            }
        ],
        "limitProfileConfig": 
            {
            "limitProfileCode": "2XKTQ3LE9NH2",
            "singleTransactionValue": 70000.00,
            "dailyTransactionVolume": 4000,
            "dailyTransactionValue": 100000000.00
             }
    }
}


    }
}



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. 

...