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_assetsarrayEvery coin and network pair, each withenabled, your choice, andoffered, 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_availablebooleanWhether card payments can be taken for your business. While it'sfalse, checkout offers crypto only, even withcardinaccepted_rails.accepted_railsarraycrypto, which is always on, andcardwhile card payments are on. Card payments arrive in a coin and network your wallet can receive and your business accepts.fee_payerstringWho pays 402pay's fees:business, billed to you as usual, orcustomer, 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_minutesintegerHow long a crypto checkout holds its address, amount and rate.underpayment_tolerance_pctnumberHow far short, in percent, a transfer can be and still count as paid in full.success_redirect_urlstringWhere checkout sends the customer after paying, whilesuccess_redirect_enabledistrue, when the link or payment has nosuccess_urlof its own. Otherwise they see the receipt.collect_emailbooleanWhether checkout asks crypto customers for an email. Card payments always need one.corner_stylestringHow round checkout draws its buttons, fields and panels:rounded, the default, orpill, with fully round buttons.fees_waivedbooleantruewhile 402pay charges no fees, so checkout adds none to a customer's total even withfee_payerset tocustomer.direct_crypto_enabledbooleanWhether 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_enabledbooleanWhether customers with no crypto can buy a stablecoin from a P2P seller on an exchange and send it to you.paypal_pyusd_enabledbooleanWhether the pay page offers PayPal: the customer buys PayPal USD in PayPal and sends it on Solana. Turning it on also turns onPYUSDonsolanainaccepted_assets.venmo_pyusd_enabledbooleanThe same for Venmo, which sends the same PayPal USD.app_methodsarrayThe finance apps the pay page can list, where the customer buys a coin and sends it to your wallet: each one'sid,name, whether it'senabled, whether it'savailable(you accept at least one of thecoinsit sends, in the order it would use them), and thecountriesit 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"] } ] }}