> For the complete documentation index, see [llms.txt](https://hot-labs.gitbook.io/hot-pay/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hot-labs.gitbook.io/hot-pay/quickstart.md).

# Quickstart

{% stepper %}
{% step %}
Open HOT PAY admin panel and login with your crypto wallet

{% embed url="<https://pay.hot-labs.org/admin/overview>" %}

<figure><img src="/files/62PWDuhVphCUFXoNBd3l" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click "**new link"** to create payment link.&#x20;

<figure><img src="/files/bnIbHGiS7yRDlwSoLIP6" alt=""><figcaption></figcaption></figure>

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

Webhook Payload Example

```json
{
  "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://hotscan.org/)
* [https://nearblocks.io](https://nearblocks.io/)

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

```bash
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.
  {% endstep %}

{% step %}
Ones payment link created, you can **share the link to your users**

<figure><img src="/files/gOtwnnlwxcM8zAIFoKVW" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Your users can connect a wallet from **20+ supported chains** and pay using **any token they hold**.

<figure><img src="/files/HfNF3VZXDiTLScWGcOa7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/upBnnJPnIn8w0BceFDyM" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="/files/1nlHz1RNoOuvvOvyeYvb" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Verify income payments with HOT PAY&#x20;

1. Add \`\&memo\` query params to your payment link. Example `https://pay.hot-labs.org/payment?item_id=3bba1f2a40f6713ff431a244ada115d09d090dddff39f5545c06c89c5c81d115&amount=0.1&memo=XXX-ID-ID`
2. Verify with webhook or query params

{% content-ref url="/pages/55krU3Bcv1NDYbmzYXJa" %}
[Developer API](/hot-pay/developer-api.md)
{% endcontent-ref %}