Skip to content
Developer
Sign inSign up

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.
  • corner_style string
    How round checkout draws its buttons, fields and panels: rounded, the default, or pill, with fully round buttons.
  • fees_waived boolean
    true while 402pay charges no fees, so checkout adds none to a customer's total even with fee_payer set to customer.
  • direct_crypto_enabled boolean
    Whether the pay page offers crypto sent from the customer's own wallet. Turned off, your coins stay on for the ways to pay that buy them (P2P and the finance apps).
  • p2p_enabled boolean
    Whether customers with no crypto can buy a stablecoin from a P2P seller on an exchange and send it to you.
  • paypal_pyusd_enabled boolean
    Whether the pay page offers PayPal: the customer buys PayPal USD in PayPal and sends it on Solana. Turning it on also turns on PYUSD on solana in accepted_assets.
  • venmo_pyusd_enabled boolean
    The same for Venmo, which sends the same PayPal USD.
  • app_methods array
    The finance apps the pay page can list, where the customer buys a coin and sends it to your wallet: each one's id, name, whether it's enabled, whether it's available (you accept at least one of the coins it sends, in the order it would use them), and the countries it serves. An app that isn't available isn't listed, even when enabled.

Errors

Only the errors any request can return. See errors.

Request
curl "https://api.402pay.co/api/v1/settings/checkout" \  -H "Authorization: Bearer $PAY402_SECRET_KEY"
Response200 OK
{  "data": {    "kind": "checkout_settings",    "accepted_assets": [      {        "asset": "USDC",        "network": "ethereum",        "enabled": true,        "offered": true      },      {        "asset": "USDC",        "network": "base",        "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      },      {        "asset": "LTC",        "network": "litecoin",        "enabled": true,        "offered": true      },      {        "asset": "TRX",        "network": "tron",        "enabled": true,        "offered": true      },      {        "asset": "PYUSD",        "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,    "corner_style": "rounded",    "card_available": true,    "fees_waived": false,    "p2p_enabled": true,    "paypal_pyusd_enabled": true,    "venmo_pyusd_enabled": true,    "direct_crypto_enabled": true,    "app_methods": [      {        "id": "paypal",        "name": "PayPal",        "enabled": true,        "available": true,        "coins": [          {            "asset": "PYUSD",            "network": "solana"          }        ],        "countries": ["US"]      },      {        "id": "cashapp",        "name": "Cash App",        "enabled": true,        "available": true,        "coins": [          {            "asset": "BTC",            "network": "bitcoin"          }        ],        "countries": ["US"]      },      {        "id": "venmo",        "name": "Venmo",        "enabled": true,        "available": true,        "coins": [          {            "asset": "PYUSD",            "network": "solana"          }        ],        "countries": ["US"]      },      {        "id": "robinhood",        "name": "Robinhood",        "enabled": true,        "available": true,        "coins": [          {            "asset": "USDC",            "network": "solana"          },          {            "asset": "USDC",            "network": "base"          },          {            "asset": "BTC",            "network": "bitcoin"          },          {            "asset": "LTC",            "network": "litecoin"          },          {            "asset": "USDC",            "network": "ethereum"          }        ],        "countries": ["US"]      },      {        "id": "coinbase",        "name": "Coinbase",        "enabled": true,        "available": true,        "coins": [          {            "asset": "USDC",            "network": "base"          },          {            "asset": "USDC",            "network": "solana"          },          {            "asset": "BTC",            "network": "bitcoin"          },          {            "asset": "LTC",            "network": "litecoin"          },          {            "asset": "USDC",            "network": "ethereum"          },          {            "asset": "USDT",            "network": "ethereum"          }        ],        "countries": [          "AT",          "AU",          "BE",          "BG",          "BR",          "CA",          "CH",          "CY",          "CZ",          "DE",          "DK",          "EE",          "ES",          "FI",          "FR",          "GB",          "GR",          "HR",          "HU",          "IE",          "IS",          "IT",          "LI",          "LT",          "LU",          "LV",          "MT",          "NL",          "NO",          "PL",          "PT",          "RO",          "SE",          "SG",          "SI",          "SK",          "US"        ]      },      {        "id": "revolut",        "name": "Revolut",        "enabled": true,        "available": true,        "coins": [          {            "asset": "USDT",            "network": "tron"          },          {            "asset": "USDC",            "network": "solana"          },          {            "asset": "USDT",            "network": "solana"          },          {            "asset": "BTC",            "network": "bitcoin"          },          {            "asset": "USDC",            "network": "ethereum"          },          {            "asset": "USDT",            "network": "ethereum"          }        ],        "countries": [          "AT",          "BE",          "BG",          "CH",          "CY",          "CZ",          "DE",          "DK",          "EE",          "ES",          "FI",          "FR",          "GB",          "GR",          "HR",          "HU",          "IE",          "IS",          "IT",          "LI",          "LT",          "LU",          "LV",          "MT",          "NL",          "NO",          "PL",          "PT",          "RO",          "SE",          "SI",          "SK"        ]      },      {        "id": "strike",        "name": "Strike",        "enabled": true,        "available": true,        "coins": [          {            "asset": "BTC",            "network": "bitcoin"          }        ],        "countries": ["US"]      },      {        "id": "gcash",        "name": "GCash",        "enabled": true,        "available": true,        "coins": [          {            "asset": "USDC",            "network": "solana"          },          {            "asset": "PYUSD",            "network": "solana"          },          {            "asset": "USDC",            "network": "base"          },          {            "asset": "USDT",            "network": "tron"          },          {            "asset": "BTC",            "network": "bitcoin"          },          {            "asset": "LTC",            "network": "litecoin"          },          {            "asset": "USDC",            "network": "ethereum"          },          {            "asset": "USDT",            "network": "ethereum"          }        ],        "countries": ["PH"]      }    ]  }}