Skip to content
Docs menu

Endpoints

Retrieve checkout settings

Get the coins, networks and rails checkout offers, and how it quotes and redirects.

The settings every hosted checkout of your business uses, for links and API payments alike.

Fields to know

  • accepted_assets array
    Every coin and network pair, each with enabled, your choice, and offered, whether checkout can take it right now. Checkout offers the pairs that are turned on, offered, and on a network your wallet can receive on.
  • card_available boolean
    Whether card payments can be taken for your business. While it's false, checkout offers crypto only, even with card in accepted_rails.
  • accepted_rails array
    crypto, which is always on, and card while card payments are on. Card payments arrive in a coin and network your wallet can receive and your business accepts.
  • fee_payer string
    Who pays 402pay's fees: business, billed to you as usual, or customer, added to each customer's total at checkout. Payments you create through the API follow it unless they set their own. See passing fees on.
  • quote_minutes integer
    How long a crypto checkout holds its address, amount and rate.
  • underpayment_tolerance_pct number
    How far short, in percent, a transfer can be and still count as paid in full.
  • success_redirect_url string
    Where checkout sends the customer after paying, while success_redirect_enabled is true, when the link or payment has no success_url of its own. Otherwise they see the receipt.
  • collect_email boolean
    Whether checkout asks crypto customers for an email. Card payments always need one.

Errors

Only the errors any request can return. See errors.

Request
curl "https://dash.402pay.co/api/v1/settings/checkout" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"
Response200 OK
{  "data": {    "kind": "checkout_settings",    "accepted_assets": [      {        "asset": "USDC",        "network": "polygon",        "enabled": true,        "offered": true      },      {        "asset": "USDC",        "network": "ethereum",        "enabled": true,        "offered": true      },      {        "asset": "USDC",        "network": "solana",        "enabled": true,        "offered": true      },      {        "asset": "USDT",        "network": "tron",        "enabled": true,        "offered": true      },      {        "asset": "USDT",        "network": "ethereum",        "enabled": true,        "offered": true      },      {        "asset": "USDT",        "network": "solana",        "enabled": true,        "offered": true      },      {        "asset": "BTC",        "network": "bitcoin",        "enabled": true,        "offered": true      },      {        "asset": "ETH",        "network": "ethereum",        "enabled": true,        "offered": true      },      {        "asset": "SOL",        "network": "solana",        "enabled": true,        "offered": true      }    ],    "accepted_rails": ["crypto", "card"],    "fee_payer": "business",    "quote_minutes": 15,    "underpayment_tolerance_pct": 0.5,    "success_redirect_enabled": false,    "success_redirect_url": null,    "collect_email": true,    "card_available": true  }}