Links & Invoices

Get paid without writing any code: a shareable link, or a proper invoice with a customer and a due date.

Payment links

A payment link is a URL you can put in a message, an email or a QR poster. Every visit mints its own payment intent, so two customers paying the same link get two different unique amounts and can never be confused for one another.

bash

curl -X POST https://api.payaider.com/v1/payment_links \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "amount": 2500,
    "currency": "EUR",
    "description": "Studio session deposit",
    "metadata": { "sku": "studio-1h" }
  }'

Omit amount for an open-amount link, where the payer chooses what to send.

Invoices

An invoice adds a customer, a number and a due date, and renders a payable page with the QR, the exact amount and the countdown.

bash

curl -X POST https://api.payaider.com/v1/invoices \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "amount": 4500000,
    "currency": "NGN",
    "customer": { "name": "Adaeze Okafor", "email": "adaeze@example.com", "country": "NG" },
    "due_date": "2026-09-03T23:59:59.000Z",
    "metadata": { "po_number": "PO-88214" }
  }'

Which one to use

Use	When
Payment intent	You have a checkout of your own and want to redirect from it.
Payment link	You want a URL or QR poster you can reuse, with no code at all.
Invoice	You need a customer on record, an invoice number and a due date.

Getting paid in a currency with a parallel FX rate

Currencies whose official and street rates diverge — NGN and its peers — are quoted from crypto-market-native sources rather than an official peg, so the amount your customer is asked for is the amount their wallet actually costs them. A currency becomes quotable only once its rate sourcing has been vetted, which is why the supported list is shorter than ISO-4217.