One-time payments - SMARTy Pay Documentation

Overview

SMARTy Pay lets you create crypto payments for your customers. We'll show you how to do this using an API call.

SMARTy Pay also provides a Payment Button within the SDK that handles the API call, simplifying the integration process.

For interacting with the payment page, the buyer will need a digital wallet. However, if the buyer does not have one, SMARTy Pay will allow them to create a wallet on the fly in the browser using special technology (this will require a standard email or a Google account).

Next, the buyer interacts with the decentralized payment protocol through their web3 wallet and confirms the payment. After that, the buyer is redirected back to the Merchant's URL.

Let's explore the whole process in more detail step by step.

Step 1. Prepare your merchant's account

Ensure your merchant's account is properly set up.

For testing payments, we recommend using the BSC TestNet and the token USDT with the code btUSDTv2 (you can obtain the token through this faucet).

Step 2. Create a Payment

Create a payment through the appropriate endpoints in the SMARTy Pay API and receive a unique payment identifier.

Request

POST

/integration/payments

curl --request POST \
  --url https://api.smartypay.io/integration/payments \
  --user API_KEY:SECRET \
  --header 'content-type: application/json' \
  --data '{
    "amount": {
        "value": "15",
        "currency": "btUSDTv2"
    },
    "expiresAt": "2025-07-29T13:51:34.755Z"
}'

Response

{
    "payment": {
      "id": "3f4pZP9dwUGDUbtVRXrjDh",
      // ... other attributes
    }
}

Step 3. Make the Payment

To make the payment, go to the payment form and provide the payment identifier (the identifier is 3f4pZP9dwUGDUbtVRXrjDh in this example):

Payment URL

https://checkout.smartypay.io/3f4pZP9dwUGDUbtVRXrjDh

For interacting with the payment form, we recommend using MetaMask. Fund your address with some btUSDTv2 tokens, as well as native BNB tokens on the BSC Test Network.

To confirm the payment, go to the payment form, connect MetaMask, and follow the instructions.

More info

You can see an example of checkout process using our demo wallet in Merchant Demo App.
More information about Checkout UI can be found here.

SMARTy Docs