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

For Headless Checkout, you specify the recipient when creating or updating an order.

Recipient by Email

When specifying a recipient by email, Crossmint will automatically create a secure custodial wallet on the fly for that email address:

Create Order
Edit Order

POST /api/2022-06-09/orders
{
  "recipient": {
    "email": "user@example.com" // Email address of the recipient
  },
  "locale": "en-US",
  "payment": {
    "method": "ethereum-sepolia",
    "currency": "eth",
    "payerAddress": "0x1234abcd...",
    "receiptEmail": "user@example.com"
  },
  "lineItems": [
    {
      "collectionLocator": "crossmint:cosdahdasda",
      "callData": {
        "totalPrice": "0.0001",
        "quantity": 1
      }
    }
  ]
}

PATCH /api/2022-06-09/orders/{orderId}
{
  "recipient": {
    "email": "user@example.com" // Email address of the recipient
  }
}

The recipient will be able to access their purchased items by logging into their Crossmint wallet in staging or mainnet.

Recipient by Wallet Address

To deliver items directly to a specific blockchain wallet address:

Create Order
Edit Order

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

POST /api/2022-06-09/orders
{
  "recipient": {
    "walletAddress": "5FHneW46xGXgs5mUiveU4sbTyGBzmstUspZC92UhjJM694ty" // For Solana
  },
  "locale": "en-US",
  "payment": {
    "method": "solana",
    "currency": "sol",
    "payerAddress": "5FHne...",
    "receiptEmail": "user@example.com" // Optional — recommended when using wallet address
  },
  "lineItems": [
    {
      "collectionLocator": "crossmint:_YOUR_SOLANA_COLLECTION_",
      "callData": {
        "totalPrice": "0.0001",
        "quantity": 1
      }
    }
  ]
}

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

PATCH /api/2022-06-09/orders/{orderId}
{
  "recipient": {
    "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.

Introduction

Hosted (pop-up)

Embedded

Headless (API)

Advanced Guides

API Reference

Digital Products

Specifying the Recipient

Recipient by Email

Recipient by Wallet Address

​Digital Products

​Specifying the Recipient

​Recipient by Email

​Recipient by Wallet Address

Digital Products

Specifying the Recipient

Recipient by Email

Recipient by Wallet Address