Specify Recipient

You can deliver items to two kinds of recipients when using Crossmint:

Digital Products

For digital items (NFTs, tokens, etc.), you can specify one of the following recipient types:

Email address: Crossmint automatically generates a secure wallet for the user's email and delivers the item inside that new wallet. Email addresses are case-insensitive.
Wallet address: Directly specify a blockchain wallet address. Receipt will be delivered to the email address specified in payment.receiptEmail. This could be a user-owned wallet (e.g., MetaMask, Phantom, etc.) or a wallet you manage. The format depends on the blockchain: - Ethereum/EVM chains: 0x1234567890abcdef1234567890abcdef12345678 - Solana: 5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty - Other chains: Contact support for format requirements

Specifying the Recipient

Embedded
Hosted
Headless

Add a recipient object to the checkout component:

Recipient by email

<CrossmintProvider apiKey="<your-client-api-key>">
    <CrossmintEmbeddedCheckout
        recipient={{
            email: "user@example.com", // Crossmint creates a custodial wallet for this email
        }}
        // other properties removed for brevity
    />
</CrossmintProvider>

Recipient by wallet address

<CrossmintProvider apiKey="<your-client-api-key>">
    <CrossmintEmbeddedCheckout
        recipient={{
            walletAddress: "0x1234567890abcdef1234567890abcdef12345678", // For EVM chains
            // walletAddress: "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty" // For Solana
        }}
        // other properties removed for brevity
    />
</CrossmintProvider>

Add a recipient object to the hosted checkout component:

Recipient by email

<CrossmintProvider apiKey="<your-client-api-key>">
    <CrossmintHostedCheckout
        recipient={{
            email: "user@example.com",
        }}
        // other properties removed for brevity
    >
        Buy with Crossmint
    </CrossmintHostedCheckout>
</CrossmintProvider>

Recipient by wallet address

<CrossmintProvider apiKey="<your-client-api-key>">
    <CrossmintHostedCheckout
        recipient={{
            walletAddress: "0x1234567890abcdef1234567890abcdef12345678", // For EVM chains
            // walletAddress: "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty", // For Solana
        }}
        // other properties removed for brevity
    />
</CrossmintProvider>

Pass the recipient when creating or updating the order:

POST /api/2022-06-09/orders
{
  "recipient": {
    "email": "user@example.com" // or "walletAddress": "0x1234..."
  },
  "locale": "en-US",
  "payment": {
    "method": "ethereum-sepolia",
    "currency": "eth",
    "payerAddress": "0x1234abcd...",
    "receiptEmail": "user@example.com" // Optional — recommended when using walletAddress
  },
  "lineItems": [
    {
      "collectionLocator": "crossmint:_YOUR_COLLECTION_ID_",
      "callData": {
        "totalPrice": "0.0001",
        "quantity": 1
      }
    }
  ]
}

PATCH /api/2022-06-09/orders/{orderId}
{
  "recipient": {
    "walletAddress": "0x1234567890abcdef1234567890abcdef12345678" // For EVM chains
    // "walletAddress": "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty" // For Solana
  }
}

If specifying a recipient by wallet address, ensure the address is valid for the chain your collection is on, which may differ from the chain the payment is performed on.

When you specify an email recipient, the buyer accesses purchased items by logging into their Crossmint wallet in staging or production.

Introduction

Quickstarts ⚡

Concepts

Guides

API Reference

Digital Products

Specifying the Recipient

Next Steps

Track Orders

Handle Errors

​Digital Products

​Specifying the Recipient

​Next Steps

Track Orders

Handle Errors

Digital Products

Specifying the Recipient

Next Steps