thirdweb Payments Documentation: Web3 Payments, On-Ramping, Bridging & Swapping

Payments empower you to create seamless and advanced payment flows for bridging, swapping, fiat on-ramping, and peer-to-peer transactions. This system has facilitated millions in NFT sales, bridged native tokens across chains, enabled stablecoin transfers, and more.

👉 Get started with thirdweb Payments today

Key Features

Cross-Chain Asset Routing

Intelligent multi-hop routing finds optimal paths between supported tokens and chains.

Fiat-to-Crypto Onramps

Integrated with Stripe, Coinbase, and Transak for smooth fiat conversions.

Real-Time Transaction Tracking

Monitor cross-chain progress with detailed status APIs.

Global Coverage

Supports 160+ regions for fiat onramps and cross-chain transactions.

Webhook Integration

Receive real-time notifications for transaction updates.

Revenue Generation

Earn fees on every transaction processed through your application.

SDK Modules

The Payments SDK is organized into functional modules:

• Bridge: Cross-chain token transfers
• Buy: Token purchase quotes and execution
• Onramp: Fiat-to-crypto integrations
• Status: Transaction progress tracking

Supported Chains

Payments is available on select EVM-compatible chains. For the full list:

👉 Explore supported chains

Quick Start

Cross-Chain ETH Purchase Example

import { Bridge, NATIVE_TOKEN_ADDRESS } from "thirdweb";

const quote = await Bridge.Buy.quote({
  originChainId: 1, // Ethereum
  originTokenAddress: NATIVE_TOKEN_ADDRESS,
  destinationChainId: 10, // Optimism
  destinationTokenAddress: NATIVE_TOKEN_ADDRESS,
  amount: toWei("0.01"),
  client: thirdwebClient,
});

Fiat Onramp via Stripe

const onramp = await Bridge.Onramp.prepare({
  client: thirdwebClient,
  onramp: "stripe",
  chainId: 1,
  tokenAddress: NATIVE_TOKEN_ADDRESS,
  receiver: "0x2a4f24F935Eb178e3e7BA9B53A5Ee6d8407C0709",
  amount: toWei("10"),
  country: "US",
});

Transaction Status Check

const status = await Bridge.status({
  transactionHash: "0x5959b9321ec581...",
  chainId: 137,
  client: thirdwebClient,
});

FAQ

What chains are supported?

Payments currently supports major EVM chains like Ethereum, Polygon, and Optimism.

How do fiat onramps work?

Integrated providers (Stripe, Coinbase) handle KYC and payment processing, delivering crypto to the specified address.

Can I track cross-chain transactions?

Yes, the Status API provides real-time updates across all hops.

How are fees calculated?

Fees are based on transaction complexity and chain conditions, displayed upfront in quotes.