Payment links
A payment link https://<your domain>/l/<slug> is reusable: put it in a chat, an e-mail, a QR on a poster, an invoice PDF. Opening it shows a "Pay" page; an invoice (with its own fresh address) is created only when the customer presses the button, then the customer continues on the payment page. Link previews (Telegram, Viber, Facebook, …) only open the page and create nothing.
အကျဉ်းချုပ် (မြန်မာ): ပမာဏ ပုံသေ (amount) သို့မဟုတ် customer ကိုယ်တိုင်ရိုက်ထည့် (min_amount/max_amount)။ Link ကို ဖွင့်ရုံနဲ့ invoice မဖန်တီးပါ — "Pay" ကို နှိပ်မှ invoice အသစ် (လိပ်စာအသစ်) ဖန်တီးပါတယ်။ Webhook / API မှာ invoice ရဲ့ payment_link က link id ပါ။
Create one in the dashboard (API → Payment links), with polysiad paylink create, or via the API.
Create — POST /v1/payment-links (scope invoices:write, Idempotency-Key required)
| Field | |
|---|---|
amount | fixed amount (USDT string) — or leave it out for a customer-entered amount: |
min_amount, max_amount | range for the customer's amount (default: the business's invoice limits) |
description | shown on the link page and the payment page (≤ 500) |
invoice_expires_in | seconds (300–86,400) for each invoice; default = business default |
redirect_url | https URL the payment page returns to after payment |
curl -sS "$API/v1/payment-links" -H "Authorization: Bearer $POLYSIA_API_KEY" \
-H "Idempotency-Key: $(cat /proc/sys/kernel/random/uuid)" -H "Content-Type: application/json" \
-d '{"amount":"15.00","description":"Yoga class (1 session)","redirect_url":"https://shop.example.com/thanks"}'
{"object":"payment_link","id":"plink_…","url":"https://pay.example.com/l/9f…","path":"/l/9f…","active":true,
"amount":"15.000000","min_amount":null,"max_amount":null,"description":"Yoga class (1 session)",
"invoice_expires_in":null,"redirect_url":"https://shop.example.com/thanks","created_at":"…","deactivated_at":null,"livemode":true}
Customer-entered amount: -d '{"min_amount":"5","max_amount":"500","description":"Donation"}'.
Get / list / deactivate (invoices:read / invoices:write)
GET /v1/payment-links/{id},GET /v1/payment-links?active=true|false(+limit,starting_after)POST /v1/payment-links/{id}/deactivate— idempotent. The link page then says "no longer active"; invoices italready created stay valid and can still be paid.
Invoices from links
They are normal invoices (GET /v1/invoices, invoice.* webhooks) with "payment_link": "plink_…", the link's description / redirect_url, order_id: null and no metadata. Match them to your records with payment_link.
Limits
Per client IP 10 invoices, then 1 per minute; per link 30, then 1 per second; the business's open-invoice cap (default 10,000; dashboard → API → Invoice settings). When a link cannot create an invoice (cap reached, or the business's limits changed so the link's amount is no longer allowed) the customer sees "cannot accept new payments right now".