Versions Compared

Key

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

Updates the information on an existing sub account Limit Profile for a merchant.

Info
titleEndpoint
PUT:

This endpoint is protected with OAuth 2.0 Bearer token

Endpoint URL: {{base_url}}/api/v1/limit-profile/2XKTQ3LE9NH2

HTTP Method: PUT

Info

The {{base_url}} for test is https://sandbox.monnify.com

/api/v1/sub-accounts

...

but when you go live, it changes to the live url

Update Limit Profile Request

Code Block
languagejs
themeMidnight
titleUpdate Sub Account Request
 {
	"subAccountCode": "MFY_SUB_319452883328",
	"currencyCode": "NGN",
	"bankCode": "058",
	"accountNumber": "0123456789",
	"email": "tamira3@gmail.com",
	"defaultSplitPercentage": "25"
}
Code Block
languagejs
themeMidnight
titleUpdate Sub Account Response
json
 {
    "limitProfileName":"Test Limit Profile Update",
    "singleTransactionValue":70000,
    "dailyTransactionVolume":4000,
    "dailyTransactionValue": 100000000
} 

Update Limit Profile Response

Code Block
languagejson
{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": [
        {
   
        "subAccountCodelimitProfileCode": "MFY_SUB_3194528833282XKTQ3LE9NH2",
   
        "accountNumberlimitProfileName": "0123456789",Test Limit Profile  Update",
        "accountNamesingleTransactionValue": "JOHN, DOE SNOW"70000,
            "currencyCodedailyTransactionVolume": "NGN"4000,
 
          "emaildailyTransactionValue": "tamira1@gmail.com",
   100000000,
        "bankCodedateCreated": "05829/10/2019 01:49:09 PM",
   
        "bankNamelastModified": "GTBank",
            "defaultSplitPercentage": 20
   29/10/2019 01:53:20 PM"
    }
    ]
}

...

Field Reference

(M) indicates fields that are mandatory in the request body

accountNumber 

Field

Description

currencyCode (M)Settlement currency. "NGN"

limitProfileName (M)

The

account number that should be created as a sub account.accountName The

name

attached to the account numberbankNameName of the bank where the account is domiciledbankCode 

of the Limit Profile

singleTransactionValue(M)

The

3 digit bank code of the bank where the account number is domiciledemail 

maximum amount that can be allowed per transaction on the reserved accounts. 

dailyTransactionVolume(M)

The

email tied to the sub account. This email will receive settlement reports for settlements into the sub account.defaultSplitPercentage 

maximum number of transaction count per day allowed on the reserved accounts 

dailyTransactionValue(M)

The

default percentage to be split into the sub account on any transaction. (Only applies if a specific amount is not passed during transaction initialization)subAccountCode (M)The unique reference for the sub account

maximum amount per day in all transactions that can be allowed on the reserved accounts

limitProfileCode

This Limit Profile code is the unique identifier for the Limit Profile used to reference the Limit Profile

...

Filter by label (Content by label)
showLabelsfalse
showSpacefalse
cqllabel

...

= "

...

reserve-account-

...

limit"

...