Accept payments
Payment links
A payment link is a page you can send in a chat, an email or put behind a button. No code on your side: every time someone opens the link, a separate invoice with its own address is created, so payments never get mixed up.
Single and reusable
| Kind | Amount | Use it for |
|---|---|---|
single | fixed | one invoice for one client, B2B bills. One payment, then the link shows "limit reached". |
reusable | fixed, or chosen by the payer between min and max | a product or service button, donations, tips. |
The payment address is given only after the payer picks a coin and network and accepts the terms. An invoice without a network does not take an address and lives 15 minutes, so a public link cannot drain the address pool. Opening a link is rate-limited per IP.
Create a link
In the dashboard: Links → Create link. With the API:
curl https://pay.axiomis.app/api/v1/payment_links -H "Authorization: Bearer $AXIOMISPAY_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Consultation, 1 hour","amount_usd_cents":12000}'| Field | Type | Notes |
|---|---|---|
name | string, required | shown on the payment page, up to 120 characters |
kind | single | reusable | default reusable |
amount_usd_cents | integer | fixed amount, $1 to $100,000 |
min_usd_cents | max_usd_cents | payer-chosen amount range (reusable only) |
assets | string[] | allowed assets, e.g. ["tron:usdt"]; default — all enabled |
max_payments | integer | stop accepting after N paid invoices |
expires_at | ISO 8601 | the link turns off after this moment |
collect_email | boolean | ask the payer for an email (saved on the invoice) |
success_url | https URL | where to send the payer after payment; default — the receipt |
metadata | object | copied to every invoice of the link |
List, read, turn off
curl https://pay.axiomis.app/api/v1/payment_links -H "Authorization: Bearer $AXIOMISPAY_KEY"
curl https://pay.axiomis.app/api/v1/payment_links/pl_… -H "Authorization: Bearer $AXIOMISPAY_KEY"
curl -X PATCH https://pay.axiomis.app/api/v1/payment_links/pl_… -H "Authorization: Bearer $AXIOMISPAY_KEY" \
-H "Content-Type: application/json" -d '{"active":false}'Each link reports payments (paid invoices) and received_usd_cents. A PATCH changes active, name or description; amounts are fixed once the link exists — create a new link instead.
Webhooks
Invoices created by a link are ordinary invoices: you receive the same invoice.* events, with payment_link_id set. external_order_id of such an invoice is <link id>:<random>.
Test links (created in test mode or with a test key) accept payments only on test networks, and their pages have the "Simulate payment" buttons.