Stripe Onramp - Trails

Stripe is a card funding provider: the user pays with a card and Trails receives USDC on Base, which then routes to the intent’s destination like any other origin funds. It joins Meld as a card-category provider, and sits alongside the Mesh exchange provider. Requires [email protected] or later.

Enable it

No SDK configuration is required — Stripe appears in the funding method list once the Trails API reports it as enabled for your project. Unlike the Mesh exchange tile, it does not depend on the onramp prop. Pass the onramp.stripe config only when you need the sandbox:

import { TrailsWidget } from '0xtrails'

<TrailsWidget
  apiKey="YOUR_TRAILS_API_KEY"
  onramp={{ stripe: { environment: 'sandbox' } }}
  renderInline
/>

Field	Values	Default
`environment`	`"sandbox"`, `"production"`	`"production"`

No Stripe key is ever passed to the SDK. Stripe credentials live in the Trails API configuration, and the browser receives only a publishable key. Contact the Trails team to have Stripe enabled for your project.

The tile renders only when the API reports Stripe as enabled for your project and country. Unlike the general onramp availability check, Stripe fails closed: while availability is pending or errored the tile stays hidden rather than showing and failing later.

Control its placement

Stripe’s identifier in fundOptions.fundMethodsList is "stripe-onramp":

<TrailsWidget
  apiKey="YOUR_TRAILS_API_KEY"
  fundOptions={{
    fundMethodsList: ['connected-wallet', 'stripe-onramp'],
    hideUnlistedFundMethods: true,
  }}
/>

From [email protected] the default order is connected wallet, Stripe, credit card (Meld), crypto transfer, then exchange (Mesh). In 0.18.3 and 0.18.4 Stripe is last. In pay mode the payment method screen ignores fundMethodsList and hideUnlistedFundMethods; Stripe shows there whenever it is enabled.

Flow

The user picks Pay with Stripe on the funding or payment method screen.
They enter an amount (in pay mode the amount is fixed by the payment request); Trails quotes the purchase.
On submit, a popup opens, the intent is committed, and Trails creates a Stripe onramp session keyed to the intent.
The user completes the card payment in the popup while the widget monitors session status.
Funds arrive as USDC on Base and the intent proceeds to its normal pending and receipt screens.

Stripe is available in fund, swap and pay modes.

Restrictions

Constraint	Value
Countries	United States and the 27 EU member states
Currency	USD only
Minimum	$1.00
Destination	USDC on Base

Stripe enforces finer restrictions of its own at session creation — certain US states and per-asset rules — which surface as an unsupported-country error during checkout rather than hiding the tile up front. Below the $1.00 minimum, production refuses to quote and the widget shows a minimum-amount message.

In sandbox, Stripe settles on Base Sepolia and always delivers a fixed 0.5 USDC regardless of the amount quoted, and source amounts below $1.00 are clamped up to $1.00. Do not read sandbox delivery amounts as a test of production quoting.

Compared with the other providers

Provider	Category	How the user pays
Stripe	Card	Card payment, settles to USDC on Base
Meld	Card	Card payment through Meld’s provider network
Mesh	Exchange	Withdraw from a linked exchange account

​Enable it

​Control its placement

​Flow

​Restrictions

​Compared with the other providers

Enable it

Control its placement

Flow

Restrictions

Compared with the other providers