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/console

Staging 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:

  1. the URL should read checkout.staging.crossmint.io, and
  2. you'll notice a yellow Test icon next to the Crossmint icon
844

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.

2880

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.