docs
On this page

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.

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
amountfixed amount (USDT string) — or leave it out for a customer-entered amount:
min_amount, max_amountrange for the customer's amount (default: the business's invoice limits)
descriptionshown on the link page and the payment page (≤ 500)
invoice_expires_inseconds (300–86,400) for each invoice; default = business default
redirect_urlhttps 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 it already created stay valid and can still be paid.

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".