Creating NFT Checkout Order

Before implementing the checkout UI, you need to create an order using the Belong.net API.

Getting API Access

To get your API key (x-api-key), please contact us at join@belong.net. We will provide you with the necessary credentials and additional information to get started.

API Endpoint

POST https://api.belong.net/api/v2/nft-checkout

Headers

Content-Type: application/json
x-api-key: YOUR_API_KEY  # Contact join@belong.net to get your API key

Request Body

{
  "collectionId": "65f1c7a33e51d8e4c2a9b4d2",
  "items": [
    {
      "name": "Test NFT #1",
      "mintPrice": 0.1,
      "image": "https://example.com/nft1.jpg",
      "quantity": 1
    }
  ]
}

Parameters Description

• collectionId (required): Your NFT collection ID
• items (required): Array of items to be minted
  • name (required): Name of the NFT
  • mintPrice (required): Price in ETH
  • image (required): URL of the NFT image
  • quantity (required): Number of copies to mint
  • description (optional): Description of the NFT
  • externalUrl (optional): External URL for the NFT

Response

{
  "data": {
    "checkoutId": "checkout_id_here"
  }
}

Using the Response

import { createPaymentFrame } from '@belongnet/sdk'

createPaymentFrame({
  el: document.getElementById('nft-checkout-frame'),
  params: {
    target: 'checkout',
    checkoutId: 'checkout_id_here',
  },
})

Example API Call

Using fetch:

const response = await fetch('https://api.belong.net/api/v2/nft-checkout', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
  },
  body: JSON.stringify({
    collectionId: '65f1c7a33e51d8e4c2a9b4d2',
    items: [
      {
        name: 'Test NFT #1',
        mintPrice: 0.1,
        image: 'https://example.com/nft1.jpg',
        quantity: 1,
      },
    ],
  }),
})

const { data } = await response.json()
const checkoutId = data.checkoutId

Using axios:

import axios from 'axios'

const { data } = await axios.post(
  'https://api.belong.net/api/v2/nft-checkout',
  {
    collectionId: '65f1c7a33e51d8e4c2a9b4d2',
    items: [
      {
        name: 'Test NFT #1',
        mintPrice: 0.1,
        image: 'https://example.com/nft1.jpg',
        quantity: 1,
      },
    ],
  },
  {
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': 'YOUR_API_KEY',
    },
  }
)

const checkoutId = data.data.checkoutId