Documentation

Checkout Quickstart

Seamless in-game checkout flow

The magic of Blockus happens when a user is ready to purchase an item. Blockus enables direct credit/debit card checkout, right in your game.

Checkout Video

Checkout Walkthrough

Equipped with your new collection and token IDs (which can be found in the dashboard under your collection page), you can now send a request for Blockus to generate a checkout URL. In the body, add a orders object that specifies the products to check out, including the collectionID, tokenID, and quantity that you want to sell/mint:

curl --request POST \
     --url https://blockus.net/v1/stores/checkout \
     --header 'X-PROJECT-ID: <yourProjectId>' \
     --header 'X-PROJECT-KEY: <yourProjectKey>' \
     --header 'X-ACCESS-TOKEN: <userAccessToken>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
		 -d '{"orders": [{ "product": {"collectionId": "XXX-XXXX-XXX","tokenId": <tokenId>},"quantity": 1}]}'↵

This call returns a checkout address that you can use to pull up the checkout flow for the order that you created. You can then use this link via a checkout or buy button in your game UI for a specific item. For Unity and Unreal, you'll need to open a

From the above request, you'll get a checkoutSessionUrl that you can now use to pull up a checkout flow.

📘

Note on versions

/v1/stores/checkout opens up a new tab in the user's browser that contains the checkout flow.
/v2/stores/checkout can be used in an in-game browser for a more seamless player experience.

It's that simple! The checkout link takes the user through the entire credit/debit card flow and also handles any error cases or KYC if needed. Once the payment is successful, Blockus automatically gets the confirmation and mints the NFT in to the player's wallet (the player is identified using the access token specified in the above checkout link request).