Update Sub Account

Update Sub Account

This endpoint updates the information on an existing sub-account for a merchant.

This endpoint is protected with OAuth 2.0 Bearer Token. To find out more about authorization for Monnify endpoints, check Here.

Endpoint URL: {{base_url}}/api/v1/sub-accounts

HTTP Method: PUT

The {{base_url}} for test is https://sandbox.monnify.com but when you go live, it changes to the live url

Sample Request

1 2 3 4 5 6 7 8 { "subAccountCode": "MFY_SUB_319452883328", "currencyCode": "NGN", "bankCode": "058", "accountNumber": "0123456789", "email": "tamira3@gmail.com", "defaultSplitPercentage": "25" }

Sample Response

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "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 Parameters

Field

Mandatory or Optional

Description

Field

Mandatory or Optional

Description

currencyCode 

M

Settlement currency. "NGN"

accountNumber

M

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

accountName 

O

The name attached to the account number

bankName

O

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