Update Sub Account

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

Endpoint

PUT: https://sandbox.monnify.com/api/v1/sub-accounts

_{This endpoint is protected with OAuth 2.0 Bearer Token}

Update Sub Account Request

 {
	"subAccountCode": "MFY_SUB_319452883328",
	"currencyCode": "NGN",
	"bankCode": "058",
	"accountNumber": "0123456789",
	"email": "tamira3@gmail.com",
	"defaultSplitPercentage": "25"
}

Update Sub Account Response

{
    "requestSuccessful": true,
    "responseMessage": "success",
    "responseCode": "0",
    "responseBody": [
        {
            "subAccountCode": "MFY_SUB_319452883328",
            "accountNumber": "0123456789",
            "accountName": "JOHN, DOE SNOW",
            "currencyCode": "NGN",
            "email": "tamira1@gmail.com",
            "bankCode": "058",
            "bankName": "GTBank",
            "defaultSplitPercentage": 20
        }
    ]
}

Field Reference

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

Field	Description
currencyCode ^(M)	Settlement currency. "NGN"
accountNumber ^(M)	The account number that should be created as a sub account.
accountName	The name attached to the account number
bankName	Name of the bank where the account is domiciled
bankCode ^(M)	The 3 digit bank code of the bank where the account number is domiciled
email ^(M)	The email tied to the sub account. This email will receive settlement reports for settlements into the sub account.
defaultSplitPercentage ^(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

Update Sub Account

Field Reference

Related Articles