v2.1 (Production)
- v2.1
- Getting Started
- Account Setup
- Idempotent Requests
- Webhook
- API Error Handling Guide
- Changelog 20260408
- Authentication
- Account Management
- Merchant Management
- Fiat Payment
- Fiat Deposit
- Fiat Account Management
- Fiat Withdrawal
- Get Same Name Withdrawal Capabilities
- Activate Same Name Withdrawal
- Submit Additional Information for Activating Same Name Withdrawal
- Activate Same Name Withdrawal Webhook
- Create Fiat Withdrawal
- Submit Additional Information for Fiat Withdrawal Request
- Get Fiat Withdrawal Detail
- Get Fiat Withdrawal History
- Fiat Withdrawal Webhook
- Crypto Payment
- Conversion
- Tool
Merchant Status Webhook
Webhook
POSTMerchant Status Webhook
API Overview#
| Item | Value |
|---|---|
| API Status | Recommended |
| Current Version | v2.0 |
| Backward Compatibility | Yes |
| Applicable Environment | Production |
| Applicable User Roles | PSP |
| Type | Webhook (Incoming) |
To update merchant status after creation or update.
Important:
Request
Authorization
Header Params
Body Params application/json
Example
{
"code": 200,
"msg": "success",
"eventType": "merchant.updated.v2",
"notificationId": "NOTIF202604150001",
"data": {
"applicationId": "2044242841240592386",
"merchantInfo": {
"participantCode": "B0100106",
"applicationType": 1,
"merchantDetails": {
"corporationDetails": {
"companyName": "TechGlobal Inc.",
"businessRegistrationNumber": "REG123456789",
"dateOfIncorporation": "2015-03-10",
"countryOfIncorporation": "US",
"registeredAddress": {
"country": "US",
"state": "Nevada",
"city": "Las Vegas",
"postcode": "89101",
"addressLine1": "456 Corporate Drive",
"addressLine2": "Suite 200"
},
"taxResidency": "US",
"email": "contact@techglobal.example.com",
"contactPerson": {
"firstName": "Edwin",
"middleName": "Marion",
"lastName": "Goyette"
},
"contactNumber": {
"countryCode": "US",
"phoneNumber": "(702) 555-6789"
},
"ubos": [
{
"firstName": "Tremayne",
"middleName": "Debra",
"lastName": "Lakin",
"dateOfBirth": "1980-07-15",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Michigan",
"city": "Detroit",
"postcode": "48201",
"addressLine1": "789 Oak Street",
"addressLine2": ""
},
"shareholdingPercentage": 68
}
]
},
"additionalCorporationDetails": {
"companyType": 1,
"otherCompanyType": "",
"operatingAddress": {
"country": "US",
"state": "Wyoming",
"city": "Cheyenne",
"postcode": "82001",
"addressLine1": "123 Business Park",
"addressLine2": "Floor 3"
},
"authSignatories": [
{
"firstName": "Marjolaine",
"middleName": "Crystal",
"lastName": "Wunsch",
"dateOfBirth": "1985-04-18",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Pennsylvania",
"city": "Philadelphia",
"postcode": "19107",
"addressLine1": "101 Market Street",
"addressLine2": "Apt 12"
}
},
{
"firstName": "Chelsie",
"middleName": "Jodi",
"lastName": "Koss",
"dateOfBirth": "1990-03-01",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Connecticut",
"city": "Hartford",
"postcode": "06103",
"addressLine1": "202 Main Avenue",
"addressLine2": ""
}
}
],
"directors": [
{
"firstName": "Zakary",
"middleName": "Caleb",
"lastName": "Dietrich",
"dateOfBirth": "1978-07-20",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "California",
"city": "San Francisco",
"postcode": "94105",
"addressLine1": "303 Tech Boulevard",
"addressLine2": "Suite 1500"
}
},
{
"firstName": "Kailey",
"middleName": "Clint",
"lastName": "West",
"dateOfBirth": "1982-12-30",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Alaska",
"city": "Anchorage",
"postcode": "99501",
"addressLine1": "404 Northern Lights Ave",
"addressLine2": ""
}
}
],
"website": "https://www.techglobal.example.com",
"natureOfBusiness": 7,
"descriptionOfBusiness": "Software development and cryptocurrency trading services",
"purposesOfAccountOpening": [
"Store Fund at MetaComp"
],
"sourceOfFunds": [
"Others",
"Business Activity"
],
"sourceOfWealth": [
"Shareholder's / Investor's Funds",
"Cryptocurrency Mining",
"Business Activity"
]
},
"supportingDocuments": [
{
"type": 16,
"fileId": "550e8400-e29b-41d4-a716-446655440000"
}
]
},
"clientReference": "REF202604150005"
},
"status": 2,
"statusInfo": "Application under review",
"updatedAt": 1744704000000
}
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://your-api-server.com' \
--header 'X-Signature: t=1758867971711,v0=b2468f1bc285eb64be242ee6d02e3c959dfb61482abe47ddb50da4b6be55997e' \
--header 'Content-Type: application/json' \
--data-raw '{
"code": 200,
"msg": "success",
"eventType": "merchant.updated.v2",
"notificationId": "NOTIF202604150001",
"data": {
"applicationId": "2044242841240592386",
"merchantInfo": {
"participantCode": "B0100106",
"applicationType": 1,
"merchantDetails": {
"corporationDetails": {
"companyName": "TechGlobal Inc.",
"businessRegistrationNumber": "REG123456789",
"dateOfIncorporation": "2015-03-10",
"countryOfIncorporation": "US",
"registeredAddress": {
"country": "US",
"state": "Nevada",
"city": "Las Vegas",
"postcode": "89101",
"addressLine1": "456 Corporate Drive",
"addressLine2": "Suite 200"
},
"taxResidency": "US",
"email": "contact@techglobal.example.com",
"contactPerson": {
"firstName": "Edwin",
"middleName": "Marion",
"lastName": "Goyette"
},
"contactNumber": {
"countryCode": "US",
"phoneNumber": "(702) 555-6789"
},
"ubos": [
{
"firstName": "Tremayne",
"middleName": "Debra",
"lastName": "Lakin",
"dateOfBirth": "1980-07-15",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Michigan",
"city": "Detroit",
"postcode": "48201",
"addressLine1": "789 Oak Street",
"addressLine2": ""
},
"shareholdingPercentage": 68
}
]
},
"additionalCorporationDetails": {
"companyType": 1,
"otherCompanyType": "",
"operatingAddress": {
"country": "US",
"state": "Wyoming",
"city": "Cheyenne",
"postcode": "82001",
"addressLine1": "123 Business Park",
"addressLine2": "Floor 3"
},
"authSignatories": [
{
"firstName": "Marjolaine",
"middleName": "Crystal",
"lastName": "Wunsch",
"dateOfBirth": "1985-04-18",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Pennsylvania",
"city": "Philadelphia",
"postcode": "19107",
"addressLine1": "101 Market Street",
"addressLine2": "Apt 12"
}
},
{
"firstName": "Chelsie",
"middleName": "Jodi",
"lastName": "Koss",
"dateOfBirth": "1990-03-01",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Connecticut",
"city": "Hartford",
"postcode": "06103",
"addressLine1": "202 Main Avenue",
"addressLine2": ""
}
}
],
"directors": [
{
"firstName": "Zakary",
"middleName": "Caleb",
"lastName": "Dietrich",
"dateOfBirth": "1978-07-20",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "California",
"city": "San Francisco",
"postcode": "94105",
"addressLine1": "303 Tech Boulevard",
"addressLine2": "Suite 1500"
}
},
{
"firstName": "Kailey",
"middleName": "Clint",
"lastName": "West",
"dateOfBirth": "1982-12-30",
"nationality": "US",
"residentialAddress": {
"country": "US",
"state": "Alaska",
"city": "Anchorage",
"postcode": "99501",
"addressLine1": "404 Northern Lights Ave",
"addressLine2": ""
}
}
],
"website": "https://www.techglobal.example.com",
"natureOfBusiness": 7,
"descriptionOfBusiness": "Software development and cryptocurrency trading services",
"purposesOfAccountOpening": [
"Store Fund at MetaComp"
],
"sourceOfFunds": [
"Others",
"Business Activity"
],
"sourceOfWealth": [
"Shareholder'\''s / Investor'\''s Funds",
"Cryptocurrency Mining",
"Business Activity"
]
},
"supportingDocuments": [
{
"type": 16,
"fileId": "550e8400-e29b-41d4-a716-446655440000"
}
]
},
"clientReference": "REF202604150005"
},
"status": 2,
"statusInfo": "Application under review",
"updatedAt": 1744704000000
}
}'Responses
🟢200Success
application/json
Body
Example
{}Modified at 2026-04-17 08:53:40