Skip to main content

Merchant checkout with Trails

Trails checkout turns “pay with crypto” into a normal Stripe charge. The shopper pays with any token they hold on any supported EVM chain; Stripe pay-with-crypto attributes the resulting USDC deposit to a PaymentIntent on your account, and you settle in USD with a Stripe-hosted receipt. Compared with Pay, where you receive tokens at an address you control, checkout ends in fiat on a processor you already use. Order management, refunds and reporting stay in Stripe.

Polygon Checkout

Accept crypto payments in your existing Stripe workflow. Book a demo, talk to sales, or ask about enabling Stripe checkout for your project.

Use cases

  • Ecommerce: a Pay with crypto option next to card and PayPal, settled in USD like every other order
  • Digital goods and tickets: sell to crypto-holding customers worldwide with Stripe-hosted receipts
  • Marketplaces and platforms: accept stablecoins without taking custody of them
  • Existing Stripe merchants: keep order management, refunds and reporting where they already are

Example

The whole integration is one widget prop. State the price in cents and pass your order reference:
onSuccess is held while Stripe confirms the deposit, so it fires after the money reaches your Stripe account rather than when the on-chain transfer lands. It also fires if the payment fails or the confirmation hold times out, with settlement.settled false, so check that flag before fulfilling.

Verify server-side

The price is declared by the browser, so always confirm the settled amount against your order before fulfilling. The canonical example is in Verify before you fulfill; the short form:

Fund the payment with a card too

A checkout can also offer the Stripe onramp tile, so a shopper with no crypto can pay the same order with a card. Both integrations are enabled per project on the Trails API side.

Next steps

Stripe checkout reference

Every prop, callback and the settlement flow

Pay

Receive tokens directly instead of settling in fiat

Settlement on the receipt

Verify payments from your backend

Stripe onramp

Card funding for shoppers without crypto