Update Merchant

Updates the details of a specific merchant.

Description

Use this endpoint to update one or more fields associated with an existing merchant.

Sandbox-Only Behavior: Simulate `kycStatus` Updates

In sandbox mode only, you can simulate updates to the merchant’s kycStatus field by using a special pattern in the localRegNumber field.

How it Works

If the localRegNumber value ends with a pipe character (|) followed by a valid KYC status, the merchant's kycStatus will be set to that value regardless of other verification steps. A webhook event will also be triggered to reflect the update.

Example

To set the kycStatus to VALID:

{
  "localRegNumber": "123456789|VALID"
}

This will update the kycStatus to VALID and send the appropriate webhook notification.

Supported `kycStatus` Values

Code	Display Name	Notes
`NEW`	New	Recently created and not yet processed – can submit onboarding
`PENDING`	Pending	Awaiting verification or further action – can submit onboarding
`PENDING_REVIEW`	Pending Review	Waiting for manual review
`UNDER_REVIEW`	Under Review	Currently being examined for verification
`ACTION_NEEDED`	Action Needed	Requires user or system intervention – can submit onboarding
`VALID`	Valid	Successfully verified and approved – can initiate transactions
`FLAGGED`	Flagged	Marked for potential issues or concerns
`ABANDONED`	Abandoned	Left incomplete or not pursued further

ℹ️ This behavior is available only in sandbox environments for testing and development purposes. In production, the kycStatus is managed through the proper verification pipeline.

Request

Path Params

Header Params

Body Params application/json

Example

{
    "name": "Company Name",
    "localRegNumber": "123456789",
    "countryIso": "NG",
    "state": "AB",
    "city": "Umuahia",
    "address": "Akanu Ibiam Rd",
    "streetNumber": "12",
    "zipcode": "12345",
    "contactName": "John Doe",
    "contactEmail": "john@company.com",
    "contactPhonePrefix": "234",
    "contactPhone": "1234567890",
    "industry": "AGRICULTURE_FORESTRY_WILDLIFE"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

Example

{
    "id": 1,
    "creationTime": 1741003185214,
    "lastUpdateTime": 1741003185214,
    "name": "Company Name",
    "localRegNumber": "123456789",
    "countryIso": "NG",
    "address": "Akanu Ibiam Rd",
    "zipcode": "12345",
    "kycStatus": "PENDING",
    "contactName": "John Doe",
    "contactEmail": "john@company.com",
    "contactPhone": "1234567890",
    "contactPhonePrefix": "234",
    "streetNumber": "12",
    "city": "Umuahia",
    "state": "AB",
    "industry": "AGRICULTURE_FORESTRY_WILDLIFE"
}

🟠400Error

Description#

Sandbox-Only Behavior: Simulate kycStatus Updates#

How it Works#

Example#

Supported kycStatus Values#

Request

Request samples

Responses

Description

Sandbox-Only Behavior: Simulate `kycStatus` Updates

How it Works

Example

Supported `kycStatus` Values