NFT Checkout Query Params
A sample query string has been attached at the end of this page.
Note: All the query parameters marked with *(asterisk) are mandatory to send to successfully load the widget and complete the transaction.
| Query Parameter | Example | Type | Default value | Description |
|---|---|---|---|---|
| apiKey * | 4fcd6904-706b-4aff-bd9d-77422813bbb7 | string | Your API key for authentication. | |
| calldata * | 0xcd279c7c0000000000000000000000 00a261da49...... | string | The calldata/hex that needs to be passed to your smart contract in order to execute the required function successfully. The calldata should contain the method ID of the function to be executed and the values of all the parameters in that function. Note: If the function to be executed accepts user's wallet address as a parameter, while generating calldata you need enter the address of Transak's smart contract on that chain as the user's wallet address. | |
| cryptoCurrencyCode * | ETH | string | The code of the cryptocurrency that your smart contract accepts in order to execute the function. You can find the list of supported cryptocurrencies here. | |
| network * | IMXZKEVM | string | A crypto network that you would allow your customers to buy NFTs on. You can get the list of supporting networks here. For ex: Ethereum | |
| estimatedGasLimit * | 34589000 | number | Gas limit that needs to be filled while executing the transaction Note: This cannot be 0 | |
| nftData * | Example | base64 encoded string | NFT data is an array that consists of only a single element. The value for this query param should be Base64 encoded. It contains: • imageURL - single field (Optional) • nftName - single field (Optional) • collectionAddress - single field • tokenID -array • price - array • quantity - single • nftType - single Note: We will consider quantity as the reference to determine the number of NFTs to be purchased. If quantity is sent as 1 and there are 4 token IDs, we’ll only consider the first token ID and price. Also the length of price and tokenID array should be same and equal to the quantity. And default value of nftType is ERC721. | |
| smartContractAddress * | 0x86349020e9394b2BE1b1262531B 0C3335fc32F20 | string | The address of the smart contract on which the calldata needs to be executed | |
| isNFT * | true | boolean | Pass this as “true”. Note: If this is passed all these query parameters should be passed compulsorily - “callData”, “cryptoCurrencyCode”, “network”, “estimatedGasLimit”, “nftData”, “smartContractAddress” | |
| walletAddress | 0x86349020e9394b2BE1b1262531B 0C3335fc32F20 | string | The blockchain address of the user's wallet that the purchased NFT will be sent to. Users will be able to edit the wallet address. The wallet address needs to be valid for the NFT and blockchain network so to make sure this works you should pass cryptoCurrencyCode or network. | |
| environment | STAGING | string | PRODUCTION | To differentiate between STAGING environment and PRODUCTION environment. Note: This param will only work with our SDK integration method. |
| fiatCurrency | GBP | string | The code of the fiat currency you want the customer to buy NFT in. If the fiat currency is not supported by a specific product type then the default widget will load with all the supported fiat currencies for that product type. You can find all the supported fiat currencies here. | |
| disablePaymentMethods | credit_debit_card | string | A comma-separated list of payment methods you want to disable and hide from the customers. | |
| [email protected] | string | The email that will be used to identify your customer and their order (usually the email that they registered with your app). Note: Please encode the email if it contains any special characters before passing it to query parameters. Otherwise, it will not be considered. Eg: [email protected] ==> Works [email protected] ==> will not work. | ||
| userData | Example | object | Here you can pass your user's data like their name, address, date of birth in the object format. If you will pass all the basic user's data, the customer won't be prompted to enter it. | |
| partnerOrderId | 5e2f559511a9de | string | An order ID that will be used to identify the transaction once a webhook is called back to your app. This can be your identifier to track your customers. | |
| partnerCustomerId | 23487492 | string | A customer ID that will be used to identify the customer that made the transaction once a webhook is called back to your app. | |
| disableWalletAddressForm | true | boolean | false | When true, the customer will not be able to change the destination address of where the cryptocurrency is sent to. Note: When this is used, walletAddress query param should be passed. |
| themeColor | 000000 | string | The theme color code for the widget main color. It is used for buttons, links and highlighted text. Only hexadecimal codes are accepted. | |
| widgetHeight | 100% | string | 100% | Height of the widget iFrame. Note: This param will only work with our SDK integration method. |
| widgetWidth | 100% | string | 100% | Widget of the widget iFrame. Note: This param will only work with our SDK integration method. |
| hideMenu | true | boolean | false | When true, then the customer will not see the menu options. This will hide the menu completely. |
| isFeeCalculationHidden | true | boolean | false | When true, then the customer will not see our fee breakdown. The customer will only see the total fee. This parameter will be ignored if your fee (on top of us) is more than 1%. |
| exchangeScreenTitle | Buy NFT | string | To change the exchange screen title. |
Sample query string:
https://global-stg.transak.com/?apiKey=9cd32351-8603-4475-8357-143f4f4cc660
&isNFT=true
&smartContractAddress=0x81064a5d163559D422fD311dc36c051424620EB9
&estimatedGasLimit=334399
&calldata=0xf6ad734200000000000000000000000076259d77a0c289b8ea0626524caf9fc9a8ec5dbf35386e674d63347632576e414d6766624452577158540000000000000000000000000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000002600000000000000000000000000000000000000000000000000000018ab5ad12ea0000000000000000000000000000000000000000000000000000000000000a40000000000000000000000000000000000000000000000000000000000000000c00000000000000000000000021b51ec6fb7654b7e59e832f9e9687f29df94fb800000000000000000000000021b51ec6fb7654b7e59e832f9e9687f29df94fb8000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000f578b6bb4fa5c7403147c29be864f5e12bf211a0000000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000180000000000000000000000000000000000000000000000000000000000000022000000000000000000000000000000000000000000000000000000000000002c0000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000003c0000000000000000000000000000000000000000000000000000000000000044000000000000000000000000000000000000000000000000000000000000004c0000000000000000000000000000000000000000000000000000000000000054000000000000000000000000000000000000000000000000000000000000005c0000000000000000000000000000000000000000000000000000000000000064000000000000000000000000000000000000000000000000000000000000006c00000000000000000000000000000000000000000000000000000000000000740000000000000000000000000000000000000000000000000000000000000006423b872dd000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000098968000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006423b872dd000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb000000000000000000000000b6e5b4c297d6b504f830d66093af4756a5ba798500000000000000000000000000000000000000000000000000000000055d4a8000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb0000000000000000000000000000000000000000000000000000000002e4b45d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb00000000000000000000000000000000000000000000000000000000019d07aa00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb0000000000000000000000000000000000000000000000000000000004a2d69d00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb0000000000000000000000000000000000000000000000000000000005065ba100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb000000000000000000000000000000000000000000000000000000000023416700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb000000000000000000000000000000000000000000000000000000000277785a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb00000000000000000000000000000000000000000000000000000000026b263f00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb00000000000000000000000000000000000000000000000000000000026410ee00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb000000000000000000000000000000000000000000000000000000000132eaaa00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004440c10f19000000000000000000000000962d7be55a4d39b61c04cf5ade72d8ee275a7bcb000000000000000000000000000000000000000000000000000000000045fd66000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041fd5dd4255e014a63159660842d0c8d84e48206e5c90d47b8102dff461b90ba9b59d1df835f775bceb26821ec4964e8079ba43cc9705c164cf13b66c924514b0b1c00000000000000000000000000000000000000000000000000000000000000
&nftData=WwoJeyAKICAgICAgICAgICAgICAgIm5mdE5hbWUiOiAiUG9rZW1vbiBNZXRhZGF0YSBMZWdlbmRzIiwKICAgICAgICAgICAgICAgICJpbWFnZVVSTCI6ICJodHRwczovL3Bva2Vtb24tbmZ0cy5zMy5hcC1zb3V0aGVhc3QtMi5hbWF6b25hd3MuY29tL2ltYWdlcy85Ni5wbmciLAoJCSJjb2xsZWN0aW9uQWRkcmVzcyI6ICIweGY1NzhiNmJCNEZBNWM3NDAzMTQ3QzI5YmU4NjRmNWUxMkJGMjExYTAiLAoJCSJ0b2tlbklEIjpbNjc2MTI1NDUsIDk4MTg2MjQwXSwKCQkicHJpY2UiOiBbMTAsMTBdLAoJCSJxdWFudGl0eSI6IDIKCX0KXQ==
&networks=immutablezkevm
&cryptoCurrencyCode=USDC
Updated about 2 hours ago