Skip to content

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

ParameterTypeRequiredDescription
mch_idintegerYesMerchant ID
noncestringYesRandom token
timestampintegerYesTimestamp
signstringYesSee Signature Algorithm

Response Fields

FieldTypeDescription
idstringMerchant ID
namestringMerchant name
created_atstringCreation 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

ParameterTypeRequiredDescription
mch_idintegerYesMerchant ID
currencystringYesCurrency code. Uppercase is recommended. See System Currency Codes
noncestringYesRandom token
timestampintegerYesTimestamp
signstringYesSee Signature Algorithm

Response Fields

FieldTypeDescription
balancenumberMerchant 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.

Released under the MIT License.