Hosted checkout.
Create fixed-price testnet orders from your dashboard, a published payment link or your backend. Real services and mainnet remain subject to activation and pilot verification.
01Configure your merchant identity
Save your business display name, accent colour and optional public contact in Checkout settings. A recent passkey approval is required. Contact email is hidden unless you explicitly publish it. Published links and existing orders retain their saved identity.
02Give each buyer a dedicated order
An explicit checkout action creates one order and its own receiving wallet. A stable Idempotency-Key recovers the same request after a lost response. Caller-supplied prices, addresses or success flags are rejected by the public start endpoint.
03Show verified payment instructions
The payment page shows the exact network, asset, amount, full address, local QR, deadline and current status. Address display waits for current custody, network monitoring, activation and pricing checks. Preparing or paused checkout never displays an invented receiving address.
04Verify before fulfillment
Read the individual order through the authenticated server API. Only payment.canFulfill=true after validated finality, exact recognition/release journals and fee assessment is eligible. Browser redirects, URL parameters and synthetic events never prove payment. Testnet and test_fixture results must remain within sandbox fulfillment.
05Resolve exceptions explicitly
Held funds do not pay an order. Partial payments show the remaining amount; overpayments remain visible. Late, early or cancelled-order payments require review. An owner/admin can accept available partial or late receipts with a passkey, revision and reason, recording any waived price. Linked refunds have their own quote, reservation and final settlement; an acceptance never refunds funds.
GET /v1/checkout/links/{publicId}
POST /v1/checkout/links/{publicId}/orders
Idempotency-Key: <stable-buyer-checkout-request>
{}
GET /v1/checkout/orders/{publicId}
// Public responses exclude private references, wallet/workspace IDs and merchant fees.
// Public status is for the buyer. Verify fulfillment through your authenticated backend.Open your workspace