Skip to main content

​
From Staging to Production with Headless Checkout

Headless checkout in production requires enablement by the Customer Success Engineering team. Contact Crossmint’s team to get access.
Crossmint provides two developer environments: staging and production. It's recommended to test end-to-end on staging before moving to production.

​
General Launch Checklist

Complete the following general steps on each tab to launch your checkout in production:

​
Collection Verification

NFT Checkout requires manual review and approval from our team to ensure compliance and quality. This is not a self-service feature. Please fill out the form here with details about what you're building so we can review your use case.
Important: In the field “Please pick the option that best matches your request”, select “I want to sell NFTs with Crossmint.”
This step only applies to NFT collections or other digital items. If you're implementing onramps only (allowing users to purchase crypto tokens directly), you can skip this step.
Collections sold using Crossmint's checkout or claims page must be verified to ensure compliance with our content policy.For full details on the project and collection verification process, requirements, and troubleshooting, please read our account verification documentation.

​
Launch Checklist

  1. Change all environment URLs from staging.crossmint.com/api/2022-06-09 to www.crossmint.com/api/2022-06-09.
  2. Change your API keys to the production versions. Ensure your production API key has the appropriate scopes enabled, such as orders.create, and that all authorized domains and mobile bundle identifiers are properly configured.
  3. Update your collection ID to the production one.
  4. As needed, change your passed-in props to be production ready (e.g. email, payment, lineItems).
// Using the REST API
fetch("https://www.crossmint.com/api/2022-06-09/orders", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_PROD_API_KEY"
  },
  body: JSON.stringify({
    "recipient": {
      "email": "steve@gmail.com"
    },
    "locale": "en-US",
    "payment": {
      "receiptEmail": "steve@gmail.com",
      "method": "ethereum",
      "currency": "eth",
      "payerAddress": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
    },
    "lineItems": [
      {
        "collectionLocator": "crossmint:YOUR_PROD_COLLECTION_ID",
        "callData": {
          "totalPrice": "0.25",
          "quantity": 1
        }
      }
    ]
  })
});