List payment methods

Retrieves all payment methods currently enabled for your store. Each entry represents a unique coin + chain combination that your store accepts.

The response is not paginated — all enabled methods are returned in a single call.

How to use this response

When creating a payment in Preselected mode, you need to pass coin and chain in payment_options.methods. Use coin.symbol and chain.symbol from this endpoint as the values — they are the canonical identifiers accepted by the API. Values are case-sensitive.

// Example: preselect USDT on TON
payment_options: {
  methods: [{ coin: "USDT", chain: "TON" }]
}

Call this endpoint at startup or cache it — the list of enabled methods changes only when your store configuration changes.

Response structure

Each item in data contains:

Field	Description
`id`	Unique identifier for this payment method configuration.
`coin.name`	Human-readable coin name, e.g. `"Tether"`.
`coin.symbol`	Ticker used in API requests, e.g. `"USDT"`.
`coin.imgUrl`	URL of the coin logo (SVG).
`chain.name`	Human-readable chain name, e.g. `"TON"`.
`chain.symbol`	Chain ticker used in API requests, e.g. `"TON"`.
`chain.imgUrl`	URL of the chain logo (SVG).

Authorization

AuthorizationBearer <token>

JWT token signed with the EdDSA algorithm. Obtain the token from the HexPay merchant dashboard and pass it via the Authorization: Bearer <token> header.

In: header

Response Body

curl -X GET "https://api.hexpay.io/v1/payment-methods"

curl -X GET "https://api.hexpay.io/v1/payment-methods"

{
  "data": [
    {
      "id": "0197ef69-6825-7bb4-8cd8-770ab407e240",
      "coin": {
        "name": "Toncoin",
        "symbol": "TON",
        "imgUrl": "https://assets.hexpay.io/coins/ton.svg"
      },
      "chain": {
        "name": "TON",
        "symbol": "TON",
        "imgUrl": "https://assets.hexpay.io/chains/ton.svg"
      }
    },
    {
      "id": "0197ef69-8297-72d3-94fb-50472539a1c8",
      "coin": {
        "name": "Tether",
        "symbol": "USDT",
        "imgUrl": "https://assets.hexpay.io/coins/usdt.svg"
      },
      "chain": {
        "name": "TON",
        "symbol": "TON",
        "imgUrl": "https://assets.hexpay.io/chains/ton.svg"
      }
    },
    {
      "id": "0197ef69-98b6-72d4-81a6-6b884fb674c2",
      "coin": {
        "name": "Notcoin",
        "symbol": "NOT",
        "imgUrl": "https://assets.hexpay.io/coins/not.svg"
      },
      "chain": {
        "name": "TON",
        "symbol": "TON",
        "imgUrl": "https://assets.hexpay.io/chains/ton.svg"
      }
    },
    {
      "id": "0197ef6a-3ffd-7ed1-8859-aeb815142b33",
      "coin": {
        "name": "Dogs",
        "symbol": "DOGS",
        "imgUrl": "https://assets.hexpay.io/coins/dogs.svg"
      },
      "chain": {
        "name": "TON",
        "symbol": "TON",
        "imgUrl": "https://assets.hexpay.io/chains/ton.svg"
      }
    },
    {
      "id": "0198b81f-4caf-72a3-a849-75b6c9bdad3e",
      "coin": {
        "name": "Blum",
        "symbol": "BLUM",
        "imgUrl": "https://assets.hexpay.io/coins/blum.svg"
      },
      "chain": {
        "name": "TON",
        "symbol": "TON",
        "imgUrl": "https://assets.hexpay.io/chains/ton.svg"
      }
    }
  ]
}

{
  "error": {
    "type": "authentication_error",
    "message": "Invalid or expired authentication token",
    "code": "auth_invalid"
  }
}

{
  "error": {
    "type": "api_error",
    "message": "An unexpected error occurred. Please retry the request or contact support.",
    "code": "internal_error"
  }
}