Merchant Info
Get Merchant Profile
Returns the basic merchant profile. This endpoint does not return account balances.
- Method:
GET - Path:
/api/v1/mch/info
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
mch_id | integer | Yes | Merchant ID |
nonce | string | Yes | Random token |
timestamp | integer | Yes | Timestamp |
sign | string | Yes | See Signature Algorithm |
Response Fields
| Field | Type | Description |
|---|---|---|
id | string | Merchant ID |
name | string | Merchant name |
created_at | string | Creation time |
Example
json
{
"code": 200,
"payload": {
"id": "10001",
"name": "Demo Merchant",
"created_at": "2026-05-04 10:00:00"
}
}Get Merchant Balance
Returns the wallet balance for a specific currency.
- Method:
GET - Path:
/api/v1/mch/balance
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
mch_id | integer | Yes | Merchant ID |
currency | string | Yes | Currency code. Uppercase is recommended. See System Currency Codes |
nonce | string | Yes | Random token |
timestamp | integer | Yes | Timestamp |
sign | string | Yes | See Signature Algorithm |
Response Fields
| Field | Type | Description |
|---|---|---|
balance | number | Merchant balance |
Example
json
{
"code": 200,
"payload": {
"balance": 23456
}
}Note
If currency is missing, the endpoint returns Missing currency param. If the merchant has no account for that currency, the request also fails directly.