# Update merchant status

Allows platforms to update the status of a merchant. This endpoint is available in non-production environments only.

Endpoint: PATCH /platform/merchants/status-update
Version: 1.0.0
Security: JWT

## Request fields (application/json):

  - `target_status` (string, required)
    The target status to update the merchant to
    Enum: "success"

  - `merchant_id` (string, required)
    The merchant for which the status is to be updated
    Example: merch_68511919RVuf6

## Response 200 fields (application/json):

  - `owner_merchant_id` (string, required)
    The ID of the platform/owner merchant
    Example: merch_68511919RVuf6

  - `merchant_id` (string, required)
    Unique identifier for the merchant
    Example: merch_68c777fcOOMpl

  - `status` (string, required)
    Current merchant status
    Enum: "success", "action_required", "pending", "failed", "offboarded"

  - `name` (string, required)
    Name of the merchant
    Example: John Doe

  - `category` (string)
    Business category
    Example: Agricultural Services

  - `entity_type` (string)
    Type of merchant entity
    Enum: "individual", "business"

  - `sub_category` (string)
    Business sub-category (must be paired with correct category)
    Example: Veterinary Services

  - `gender` (string)
    Gender (only required for individual entity_type)
    Enum: "male", "female", "undefined"

  - `date_of_birth` (string)
    Date of birth (only required for individual entity_type)
    Example: 2001-08-04

  - `registration_number` (string, required)
    Business registration number or individual ID
    Example: REG123456

  - `registration_country` (string, required)
    Country where the merchant is registered (ISO 3166-1 alpha-3)
    Example: IND

  - `address` (object, required)
    Merchant address

  - `address.address_line1` (string, required)
    Primary address line
    Example: 123 Main St

  - `address.address_line2` (string)
    Secondary address line (optional)

  - `address.city` (string, required)
    City name
    Example: Bangalore

  - `address.state` (string, required)
    State or province
    Example: Karnataka

  - `address.pincode` (string, required)
    Postal/ZIP code
    Example: 560060

  - `address.country` (string, required)
    Country code (ISO 3166-1 alpha-3)
    Example: IND

  - `operation_countries` (array, required)
    List of countries where the merchant operates
    Example: ["IND"]

  - `created_at` (string, required)
    Timestamp when the merchant was created
    Example: 2025-10-07T06:11:47Z

  - `updated_at` (string, required)
    Timestamp when the merchant was last updated
    Example: 2025-10-07T06:11:47Z

  - `jwt_token` (string, required)
    JWT token for the merchant
    Example: child_merchant_JWT

  - `public_key` (string)
    public key for the merchant
    Example: live_6889e287VfqrPVPg

## Response 400 fields (application/json):

  - `error` (string)
    Example: Bad Request

  - `message` (string)
    Example: Invalid merchant status update

## Response 401 fields (application/json):

  - `error` (string)
    Example: Unauthorized

  - `message` (string)
    Example: Unauthorized