Skip to main content
StellarX402 payments happen on Stellar’s Soroban smart contract layer. Two networks and any SEP-41 token whitelisted by the facilitator are supported.

​
Networks

Both identifiers follow CAIP-2. Clients and servers must agree on the network in both PaymentRequirements and PaymentPayload. See Supported Networks for the full reference.

​
Tokens

Any SEP-41 compliant Soroban token can be used, subject to the facilitator’s ALLOWED_ASSETS whitelist. The default and only widely deployed choice today is USDC. Full list and up-to-date addresses: Supported Assets.

​
Amount formatting

Amounts in PaymentRequirements.amount are stringified integers in the token’s smallest unit (amount * 10^decimals). For USDC with 7 decimals: Use the SDK’s formatAmount and parseAmount helpers rather than doing this by hand.

​
Operator flags

Operators control which networks and assets their facilitator serves via:
  • NETWORK (single network per instance)
  • ALLOWED_ASSETS (comma-separated symbols)
See Configuration Reference.