Test Your Integration
Make sure your integration is working well before releasing your NFT drop into production with the various tools Crossmint provides you for testing purposes.
Crossmint allows you to test your integration before releasing into production for the various blockchains that we support. Read the instructions below to learn more.
Staging and Production Consoles
We have two distinct developer console environments:
Staging - https://staging.crossmint.io/console
Production - https://www.crossmint.io/consoleStaging is used to configure projects with smart contracts or candy machines that are deployed to a testnet. Production is for mainnet smart contracts and candy machines.
Modify the Crossmint button for local testing
To test your Crossmint integration locally, add the attribute environment="staging"
to the Crossmint button.
Here's an example using our React.js Client SDK, but adding the environment
attribute works in the same when using our VanillaJS SDK:
<CrossmintPayButton
clientId="<YOUR_CLIENT_ID>"
environment="staging"
/>
If you don't enter the
environment="staging"
attribute on your button it won't work.Please ensure it's there.
For a more in-depth button integration example, see the Integrate pages for the blockchain that you're building for.
Test the payment flow
When testing, use the card number 4242 4242 4242 4242
. Use any three-digit CVC and a valid future date, such as 12/34
.
You'll know on the test payment flow through a few indicators:
- the URL should read
checkout.staging.crossmint.io
, and - you'll notice a yellow
Test
icon next to the Crossmint icon

Crossmint's Payment Flow Popup
Implement Blockchain-specific testing instructions
Crossmint supports testing on various Devnets and Testnets on different blockchains. Below are the instructions you need for each blockchain to get set up and properly test your NFT drop.
Solana Candy Machines that are set up on Devnet are supported for testing purposes. If you originally created your Candy Machine on Mainnet, make sure you re-create one on Devnet to go through the testing process using Test SOL.
After setting up your Candy Machine on Devnet you can proceed with the remainder of the Integration guide for Candy Machine.
We also wrote an article for you that guides you through the process of setting up your own Candy Machine completed with credit card integration from start to finish if that's a more convenient option.
https://medium.com/crossmint-tech/how-to-launch-a-solana-nft-collection-with-credit-card-support-using-candy-machine-e740cffee1bc
Crossmint supports testing on the Mumbai Testnet. If you've already set up your smart contract on Mainnet please create it on Mumbai for smooth testing using test MATIC.
Note: When testing your drop on Mumbai, our recommendation is that you use very low MATIC prices, for example 0.0001.
If you created your Crossmint collection by registering your Mainnet contract address, make sure you recreate it using the Mumbai Testnet contract address. Now you can proceed with the rest of the Polygon integration guide.
Crossmint supports testing on Rinkeby. When you register your Contract Address in the Developer Console it can be a Rinkeby Testnet address.
Our address, 0xdAb1a1854214684acE522439684a145E62505233, is the same for testing on Rinkeby and for production on Mainnet.
After deploying your smart contract Rinkeby, make sure you create a new collection in the Crossmint Staging Developer Console using those details. Now you can proceed with the remainder of the Ethereum Integration guide.
We wrote an article for you that guides you completely step by step through the process. You'll set up an Ethereum NFT collection using ERC721 including Crossmint integration.
https://docs.crossmint.io/docs/polygon
Crossmint supports testing on Rinkeby. When you register your Contract Address in the Developer Console it can be a Rinkeby Testnet address.
Note: Our address, 0xdAb1a1854214684acE522439684a145E62505233, is the same for testing on Rinkeby and for production on Mainnet.
After deploying your smart contract Rinkeby, make sure you create a new collection in the Crossmint Staging Developer Console using those details. Now you can proceed with the remainder of the Ethereum Integration guide.
https://docs.crossmint.io/docs/ethereum
We wrote an article for you that guides you completely step by step through the process. You'll set up an Ethereum NFT collection using ERC721 including Crossmint integration.
https://medium.com/crossmint-tech/ethereum-nft-collection-credit-card-support-15101f399fdd
Resolve smart contract issues
If there are issues with your smart contract's code, you'll have to fix those issues and then re-compile the smart contact. Then redeploy it to the blockchain.
Withing the Staging Developer Console and create a collection, re-enter:
- the new contract's address
- function params
- and the ABI for your minting function
Get your brand new Crossmint Client ID and update the details for the Crossmint button your website.
Still having problems?
We're here to help! Reach out to our support team and we're happy to assist with any technical issues related to Crossmint integration you might bump into.
See your Testnet NFT on Crossmint
After going completely through the testing flow and testing the payment, visit your Crossmint collection page and see your freshly minted NFT in your account. Make sure you use the same email that you entered in the popup when purchasing the NFT. If everything went smoothly it should now appear in your account.

Crossmint's collection page where you can see your minted NFTs
Getting ready for production
After successfully testing your Crossmint integration and resolving all issues it's now time to get ready for launching on a Mainnet. See our Production Launch Checklist to make sure you're fully prepared for launch.
Can we help?
Our support team is here to help you resolve any Crossmint-related issues that might come up during integration. If you have any questions you can reach out to our customer support team via [email protected] or join us on Discord.
Updated 3 months ago