Quickstart

1

Open HOT PAY admin panel and login with your crypto wallet

HOT Paypay.hot-labs.org

2

Click "new link" to create payment link.

Field	Required	Description
Link Name	Yes	Name of the product or service associated with this payment link. Will be displayed on the checkout page.
Description	No	Short description of the product or service associated with this payment link. Will be displayed on the checkout page.
Icon URL	No	Public URL of an image representing the product or service. Supported formats: PNG, JPG, SVG Recommended size: square (1:1) Commonly hosted on IPFS or a CDN. The icon is displayed on the checkout page.
Product Price	No	Fixed price for the product or service. If provided, the user will not be able to change the amount. If left empty, the price must be passed dynamically via URL query parameters (e.g. &amount=12.5), or user will be able to input it by himself Example: https://pay.hot-labs.org/payment?item_id=b9d04a8f868d5c5a1e8b3ce432e9ec74af643a69c053a3fec13a99ac1dee599d&amount=12
Payment Token	Yes	Token you want to receive payments in (e.g. USDC). Users can pay from any supported chain and token, payments are automatically converted to the selected token.
Redirect Domain	No	Domain where the user will be redirected after a successful payment. Example: example.com Only the domain is required (no protocol or path).Used for redirect validation and security. A full redirect URL can be provided dynamically via query parameters: &redirect_url=https://example.com/success Example: https://pay.hot-labs.org/payment?item_id=<ITEM_ID>&amount=12&redirect_url=https://example.com/success
Webhook URL	No	HTTPS endpoint that receives server-to-server payment notifications. Triggered after payment confirmation and used for backend processing. Webhooks are sent even if the user does not return via redirect.

Webhook Payload Example

{
  "type": "PAYMENT_STATUS_UPDATE",
  "item_id": "aed163adfe8e5c...",
  "status": "SUCCESS",
  "memo": "ORDER_982374",
  "amount": "125000000",
  "amount_float":12.50,
  "amount_usd":12.4999,
  "near_trx": "Aad73RvHh7XYgmC2dWySEbNb9HjuFbTJTa1w9eTSniYh"
}

Transaction hashes can be verified on:

• https://hotscan.org

• https://nearblocks.io

You can trigger a test webhook delivery using the following request:

curl -X POST \
  'https://api.hot-labs.org/partners/merchant_item/{YOUR_ITEM_ID}/test_webhook' \
  -H 'accept: application/json' \
  -d ''

Notes

• All payments are processed on-chain.

• If both Product Price and amount URL parameter are provided, Product Price takes precedence.

• Merchants are responsible for validating and reconciling payments using on-chain data or webhooks.

3

Ones payment link created, you can share the link to your users

4

Your users can connect a wallet from 20+ supported chains and pay using any token they hold.

5

Once a payment is received, the transaction will appear in the admin panel, and you can withdraw the received tokens to any supported chain.

Verify income payments with HOT PAY

Developer API