---
title: "Payment rails, their minimums and payable coin/network pairs"
method: GET
path: "/api/public/payment-methods"
---

# Payment rails, their minimums and payable coin/network pairs

`GET /api/public/payment-methods`

## Request

- Base URL: `https://kodshop.cloud`
- URL: `https://kodshop.cloud/api/public/payment-methods`
- Auth: none required

Read this before creating an order you intend to pay for. Lists only the rails this deployment serves, each with the minimum order it accepts and — for the crypto rail — the exact (currency, network) pairs an invoice can be pinned to, with per-coin limits. Both facts were previously only discoverable by getting rejected: the floor after the order already existed, the coin list one 400 per guess. coins_stale=true means the gateway lookup failed and the list is a known-good fallback rather than live.

## Response `200`

Available rails

- object
  - `currency` string
  - `docs` string, uri
  - `rails` object[]
    - `rail` 'crypto' | 'x402'
    - `endpoint` string, uri
    - `currency` string
    - `min_order` string: Smallest order total this rail accepts, decimal string in currency
    - `description` string
    - `network` string: x402 only — settlement chain
    - `asset` string: x402 only — USDC contract address
    - `coins_stale` boolean: crypto only — true when coins is the fallback list, not a live gateway lookup
    - `coins` object[]: crypto only — payable pairs for to_currency + network
      - `currency` string
      - `network` string
      - `min_amount` string
      - `max_amount` string

---

[API](https://skmtc.dev/kodshop/apis/kodshop-public-api.md) · [All operations](https://skmtc.dev/kodshop/apis/kodshop-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kodshop/apis/kodshop-public-api/revisions/63f1271e61ea?raw)
