Current merchant

GET

/api/v1/merchants/me

Returns the merchant bound to your API credentials. Use this as a connectivity
and setup check before going live.

Do this

Call once after you store the key/secret (and after rotating them).

Require merchant.status = active before creating invoices.

Confirm

200, merchant.id is a UUID, status is active.

401 → key or secret wrong (send both headers).

403 account_suspended → do not create invoices.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

API Key

Add parameter in header

X-API-Secret

Example:

X-API-Secret: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200

application/json

Merchant profile

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠429RateLimited

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/merchants/me' \
--header 'X-API-Key: <api-key>' \
--header 'X-API-Secret: <api-key>'

Response Example

200 - Current merchant

{
    "merchant": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "name": "Demo Store",
        "email": "merchant@example.com",
        "status": "active"
    }
}

Modified at 2026-08-17 11:17:23

Cancel invoice

Receive Autopay webhook