# 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="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2FMk4F27zFCENhd9vfYOFL%2Fimage.png?alt=media&#x26;token=a22f4af0-65fa-4d6b-afe0-74956fc283e3" alt=""><figcaption></figcaption></figure>
{% endstep %}

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

<figure><img src="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2FuUrOZbv3h7wV5nH643n3%2Fimage.png?alt=media&#x26;token=8546a839-2d59-4280-9a30-2c63df5f6211" 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="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2FzbOP0NQIR98loMSbbTtj%2Fimage.png?alt=media&#x26;token=6ddd297d-6060-403d-a271-bad98a5eb9d1" 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="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2Fr5ty8TniIrQMFGKI9Mqx%2Fimage.png?alt=media&#x26;token=f85de02f-d99e-4865-b7b5-8c499a47bd62" 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="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2FF0zhWxyGxZAOnbkea2wA%2Fimage.png?alt=media&#x26;token=d325a0f9-093c-45b6-be3b-7a8a074debb1" 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="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2F4gOhxegmXrmuBP4L52j9%2Fimage.png?alt=media&#x26;token=ac1d346b-a1e3-4ef2-aa90-2c36a33ba9d7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2FTuJf95oGYIKd7RJ7OjYP%2Fimage.png?alt=media&#x26;token=ded16c98-7532-4037-8609-70b1d9ff6d8d" 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="https://2106843801-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FskGFxeUNarVcGGepxsTW%2Fuploads%2FgyTo9PTYfYkeGoVq1Bf7%2Fimage.png?alt=media&#x26;token=7aabfe32-ce0c-4eb3-a131-79279518cb27" 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="developer-api" %}
[developer-api](https://hot-labs.gitbook.io/hot-pay/developer-api)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hot-labs.gitbook.io/hot-pay/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.