Update a merchant

API reference

Update a merchant

Request

Updates an existing merchant. Currently supports attaching a passport object for individual merchants and a registration_date for business merchants; more fields may be supported in future.

The applicable field is determined by the merchant's entity type, set at onboarding, rather than by the request body: send passport for an individual merchant and registration_date for a business merchant. A field that does not apply to the merchant's entity type is ignored.

Security

JWT

Path

merchant_idstringrequired

Unique identifier of the merchant. Starts with merch_ followed by letters and digits. An ID of any other shape, or one that doesn't match a merchant under your platform account, returns 404.

Example:merch_68c777fcOOMpl

Bodyapplication/jsonrequired

One of:

Fields to update on an existing merchant. Currently supports passport for individual merchants and registration_date for business merchants; more fields may be supported in future. The applicable field is determined by the merchant's entity type, set at onboarding, rather than by the request body. A field that does not apply to the merchant's entity type is ignored.

passportobjectrequired

Passport identification (individual merchants)

curl -i -X PATCH \
  https://api.glomopay.com/api/v1/platform/merchants/merch_68c777fcOOMpl \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "passport": {
      "number": "P1234567",
      "expiry_date": "2030-06-01",
      "country_of_issuance": "IND"
    }
  }'

Responses

Merchant updated successfully

Bodyapplication/json

owner_merchant_idstringrequired

The ID of the platform/owner merchant

Example:"merch_68511919RVuf6"

merchant_idstringrequired

Unique identifier for the merchant

Example:"merch_68c777fcOOMpl"

statusstringrequired

Current onboarding status of the merchant.

created — the merchant has been submitted and screening has not finished.
action_required — screening flagged the merchant and Glomo is reviewing it before onboarding can continue.
pending — screening passed and the merchant's KYC or KYB review is in progress.
success — the merchant is onboarded and can transact.
failed — onboarding was rejected. Terminal.
offboarded — a previously onboarded merchant has been removed. Its API keys stop working and it can no longer transact. Terminal.

Enum:"created""action_required""pending""success""failed""offboarded"

Example:"success"

namestringrequired

Name of the merchant

Example:"John Doe"

categorystring

Business category

Example:"Agricultural Services"

entity_typestring

Type of merchant entity

Enum:"individual""business"

Example:"individual"

sub_categorystring

Business sub-category (must be paired with correct category)

Example:"Veterinary Services"

genderstring

Gender (only required for individual entity_type)

Enum:"male""female""undefined"

Example:"male"

date_of_birthstring, (date)

Date of birth, as a calendar date in YYYY-MM-DD format with no time or time zone. Present only when entity_type is individual.

Example:"2001-08-04"

registration_numberstringrequired

Business registration number or individual ID

Example:"REG123456"

registration_countrystringrequired

Country where the merchant is registered (ISO 3166-1 alpha-3)

Example:"IND"

addressobjectrequired

Merchant address

operation_countriesArray of stringsrequired

List of countries where the merchant operates

Example:

[
  "IND"
]

created_atstring, (date-time)required

When the merchant was created, as an ISO 8601 date-time in UTC.

Example:"2025-10-07T06:11:47Z"

updated_atstring, (date-time)required

When the merchant was last updated, as an ISO 8601 date-time in UTC.

Example:"2025-10-07T06:11:47Z"

jwt_tokenstringrequired

JWT token for the merchant

Example:"child_merchant_JWT"

public_keystring

public key for the merchant

Example:"live_6889e287VfqrPVPg"

Response

{
  "owner_merchant_id": "merch_68511919RVuf6",
  "merchant_id": "merch_68c777fcOOMpl",
  "status": "success",
  "name": "John Doe",
  "category": "Agricultural Services",
  "entity_type": "individual",
  "sub_category": "Veterinary Services",
  "gender": "male",
  "date_of_birth": "2001-08-04",
  "registration_number": "REG123456",
  "registration_country": "IND",
  "address": {
    "address_line1": "123 Main St",
    "address_line2": "",
    "city": "Bangalore",
    "state": "Karnataka",
    "pincode": "560060",
    "country": "IND"
  },
  "operation_countries": [
    "IND"
  ],
  "created_at": "2025-10-07T06:11:47Z",
  "updated_at": "2025-10-07T06:11:47Z",
  "jwt_token": "child_merchant_JWT",
  "public_key": "live_6889e287VfqrPVPg"
}