Merchant API
Auth

Identify the API key holder

Return the merchant identity stamped from the caller's API key: organisation, merchant, and the key's environment. Use this to verify a key without provoking a write.

GET
/me

Return the merchant identity stamped from the caller's API key: organisation, merchant, and the key's environment. Use this to verify a key without provoking a write.

AuthorizationBasic <token>

Merchant API key pair. Send as Authorization: Basic base64(publicKey:secretKey) — username is the public key (pk_live_… / pk_test_…), password is the secret key (sk_live_… / sk_test_…). The public key prefix determines the environment of every order created by the request — there is no body, query, or header override.

In: header

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/me"
{
  "environment": "test",
  "merchant_id": "mch_01HZYABCDXYZ",
  "organization_id": "org_01HZYABCDXYZ"
}
{
  "error": {
    "code": "validation_failed",
    "message": "Currency XYZ is not enabled for this merchant."
  }
}
{
  "error": {
    "code": "validation_failed",
    "message": "Currency XYZ is not enabled for this merchant."
  }
}