Enable Payment Methods

This guide shows how to choose the payment methods buyers see in checkout. For a description of each method, see Payment Methods.

Configure Payment Methods

Embedded
Hosted
Headless

Embedded Checkout enables all payment methods by default. Configure them with the payment prop:

<CrossmintEmbeddedCheckout
    lineItems={{
        collectionLocator: `crossmint:${collectionId}`,
        callData: {
            totalPrice: "0.001",
            quantity: 1,
        },
    }}
    payment={{
        crypto: {
            enabled: true, // Enable crypto payments
            defaultChain: "ethereum", // Optional: set default blockchain
            defaultCurrency: "usdc", // Optional: set default currency (usdc, eurc, eth)
        },
        fiat: {
            enabled: true, // Enable fiat payments
            // By default, all fiat methods are enabled if you don't specify any
            allowedMethods: {
                card: true, // Enable/disable credit cards
                applePay: true, // Enable/disable Apple Pay
                googlePay: true, // Enable/disable Google Pay
            },
            defaultCurrency: "usd", // Set default currency
        },
        defaultMethod: "fiat", // Optional: "fiat" or "crypto"
    }}
/>

Crypto payments work with any web3 wallet, including MetaMask, Coinbase Wallet, WalletConnect, and Phantom. For higher conversion, offer both fiat and crypto, and set a default that matches your target market.

Hosted Checkout accepts the same payment types through the payment prop:

<CrossmintHostedCheckout
    payment={{
        fiat: {
            enabled: true,
            defaultCurrency: "usd", // Set preferred fiat currency
        },
        crypto: {
            enabled: true,
            defaultChain: "polygon", // Set preferred blockchain
            defaultCurrency: "pol", // Set preferred crypto
        },
        defaultMethod: "fiat", // Optional: "fiat" or "crypto"
        receiptEmail: "buyer@example.com", // Optional: receipt email
    }}
/>

Headless checkout supports card payments and cross-chain crypto payments. You choose the method per order through the payment object when you create or update it:

Card

{
    "payment": {
        "method": "card",
        "receiptEmail": "buyer@example.com"
    }
}

Crypto

{
    "payment": {
        "method": "ethereum-sepolia",
        "currency": "usdc",
        "payerAddress": "0x1234abcd..."
    }
}

For crypto, method is the chain the buyer pays on — it can differ from the chain the asset lives on. When you build the payment-method selection UI, filter the supported currencies down to those where the buyer’s wallet has enough balance, and make sure the wallet is set to the same network as the selected payment chain. See How Checkout Works for the order lifecycle.

Test Payment Methods

In the staging environment you can use test card numbers and test wallets to exercise the full flow without real money. See price limits and test card numbers.

Introduction

Quickstarts ⚡

Concepts

Guides

API Reference

Configure Payment Methods

Test Payment Methods

Next Steps

Payment Methods

How Checkout Works

​Configure Payment Methods

​Test Payment Methods

​Next Steps

Payment Methods

How Checkout Works

Configure Payment Methods

Test Payment Methods

Next Steps