Merchant Status Webhook

Webhook

POST

Outbound notification sent when a merchant's status changes (e.g., KYC approved or rejected). Payload includes applicationId, full merchantInfo, current status, statusInfo (rejection reason if applicable), and updatedAt.

This is a webhook to be implemented by the partner — you expose a public endpoint matching this contract, and the platform pushes status updates to it.

Merchant activation

The payload carries data.activationStatus. Activation itself does not trigger this webhook (the activated status is returned synchronously by Confirm Merchant Activation); this webhook fires on the merchant's existing KYC-status changes and additionally carries activationStatus.

Request

Authorization

Header Params

Body Params application/json

Example

eventType: merchant.updated.v2

{
    "data": {
        "activationStatus": "NO_NEED_ACTIVATION",
        "applicationId": "2079095640870268930",
        "merchantInfo": {
            "applicationType": 1,
            "clientReference": "cw-wh2-1784529998",
            "merchantDetails": {
                "personalDetails": {
                    "contactNumber": {
                        "countryCode": "65",
                        "phoneNumber": "91234567"
                    },
                    "dateOfBirth": "1990-01-01",
                    "email": "hook2@example.com",
                    "firstName": "Hook2",
                    "lastName": "Test",
                    "nationality": "SG",
                    "residentialAddress": {
                        "addressLine1": "1 St",
                        "city": "SG",
                        "country": "SG",
                        "postcode": "123456"
                    },
                    "taxResidency": "SG"
                },
                "supportingDocuments": [
                    {
                        "fileId": "18fa3801-b246-4c2e-bc7f-511596c8affa",
                        "type": 1
                    }
                ]
            },
            "participantCode": "A0104989"
        },
        "status": 2,
        "statusInfo": "APPROVED",
        "updatedAt": 1784530018348
    },
    "eventType": "merchant.updated.v2",
    "notificationId": "02985dac-65e5-45ed-80c3-4fc2ad1bf879"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://your-api-server.com' \
--header 'X-Signature: t=1758867971711,v0=b2468f1bc285eb64be242ee6d02e3c959dfb61482abe47ddb50da4b6be55997e' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "activationStatus": "NO_NEED_ACTIVATION",
        "applicationId": "2079095640870268930",
        "merchantInfo": {
            "applicationType": 1,
            "clientReference": "cw-wh2-1784529998",
            "merchantDetails": {
                "personalDetails": {
                    "contactNumber": {
                        "countryCode": "65",
                        "phoneNumber": "91234567"
                    },
                    "dateOfBirth": "1990-01-01",
                    "email": "hook2@example.com",
                    "firstName": "Hook2",
                    "lastName": "Test",
                    "nationality": "SG",
                    "residentialAddress": {
                        "addressLine1": "1 St",
                        "city": "SG",
                        "country": "SG",
                        "postcode": "123456"
                    },
                    "taxResidency": "SG"
                },
                "supportingDocuments": [
                    {
                        "fileId": "18fa3801-b246-4c2e-bc7f-511596c8affa",
                        "type": 1
                    }
                ]
            },
            "participantCode": "A0104989"
        },
        "status": 2,
        "statusInfo": "APPROVED",
        "updatedAt": 1784530018348
    },
    "eventType": "merchant.updated.v2",
    "notificationId": "02985dac-65e5-45ed-80c3-4fc2ad1bf879"
}'

Responses

🟢200Success

application/json

Bodyapplication/json

Example

{}

Modified at 2026-07-20 06:48:10

Get Merchant

Get Deposit Bank Account