Skip to main content
GET
/
api
/
v1
/
external
/
payment-methods
/
config
GET https://app.fire.rest/api/v1/external/payment-methods/config
x-api-key: <your_api_key>

{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "countries": [
    {
      "countryCode": "EC",
      "vendors": [
        {
          "vendorId": "100.1.10",
          "vendorName": "Sandbox Ecuador",
          "paymentMethods": [
            {
              "uuid": "9f3a-...-e1",
              "code": "CASH",
              "name": "Cash",
              "description": null,
              "enabled": true
            },
            {
              "uuid": "7e2b-...-c8",
              "code": "CREDIT_CARD",
              "name": "Credit card",
              "description": "Visa, Mastercard",
              "enabled": true
            },
            {
              "uuid": "abcf-...-2d",
              "code": "PlaceToPay",
              "name": "PlaceToPay",
              "description": null,
              "enabled": false
            }
          ]
        }
      ]
    }
  ]
}
Returns the full payment-methods configuration for the vendor bound to your API key, enriched with global catalog data (uuid, name, description). The endpoint takes no query parameters — accountId and vendorId are derived from the API key. All methods are returned (enabled and disabled) so the client can decide what to show. Methods in the account JSONB without a catalog match are excluded.

​
Authentication

​
x-api-key
string
required
Your Fire API key with the payment-methods:read scope. The key must be vendor-scoped (account + vendor binding) — keys without a vendorId are rejected with 403.

​
Request

GET https://app.fire.rest/api/v1/external/payment-methods/config
x-api-key: <your_api_key>

​
Response

​
accountId
string
UUID of the account the API key belongs to.
​
countries
object[]
{
  "accountId": "550e8400-e29b-41d4-a716-446655440000",
  "countries": [
    {
      "countryCode": "EC",
      "vendors": [
        {
          "vendorId": "100.1.10",
          "vendorName": "Sandbox Ecuador",
          "paymentMethods": [
            {
              "uuid": "9f3a-...-e1",
              "code": "CASH",
              "name": "Cash",
              "description": null,
              "enabled": true
            },
            {
              "uuid": "7e2b-...-c8",
              "code": "CREDIT_CARD",
              "name": "Credit card",
              "description": "Visa, Mastercard",
              "enabled": true
            },
            {
              "uuid": "abcf-...-2d",
              "code": "PlaceToPay",
              "name": "PlaceToPay",
              "description": null,
              "enabled": false
            }
          ]
        }
      ]
    }
  ]
}

​
Notes

  • uuid comes from the global payment_methods catalog, not from the per-account JSONB.
  • Disabled methods are included so you can render them with an “unavailable” state or hide them — it is your decision.
  • countries groups by country code from the JSONB.

Channels config

Companion endpoint to read configured sales channels.

Authentication

How vendor-scoped API keys and scopes work.