API reference

Payment links

A sharable hosted-checkout URL —baynoy.com/pay/plink_xxx. Customers tap the link, enter contact info and payment, get a receipt. Use for one-off invoices, donation drives, or any case where a full Stripe Elements integration is overkill.

Create a payment link

POST/v1/payment-linksscope: payment_links:write

Lands as an active link immediately. Use the slug in the response to build the customer-facing URL https://baynoy.com/pay/{slug}.

Body parameters

`title`required string	Headline shown to the customer on the hosted page.
`description` string	Short subtitle. Markdown not supported — plain text only.
`amount` number	Fixed price in minor units. Omit for customer-set (tip / donate) links.
`currency`required string	ISO 4217 code.
`taxBps` number	Tax rate in basis points (0–10000 → 0%–100%). Applied tax-exclusively on top of `amount`.
`methods` array	Whitelist of payment methods. One of: `card`, `apple_pay`, `google_pay`, `klarna`, `cashapp`
`successUrl` string	Override the default `/pay/{slug}/done` page with your own redirect.
`cancelUrl` string	URL to send buyers who abandon checkout.

curl https://baynoy.com/api/v1/payment-links \
  -H "Authorization: Bearer sk_live_…" \
  -d '{
    "title": "Translation service",
    "description": "Document translation fee",
    "amount": 200,
    "currency": "CHF"
  }'

Response

{
  "ok": true,
  "data": {
    "id": "plnk_a1b2c3-...",
    "slug": "plink_p5oxzl70su67afpq",
    "title": "Translation service",
    "amount": "200",
    "currency": "CHF",
    "taxBps": 0,
    "methods": ["card", "apple_pay", "google_pay"],
    "archivedAt": null,
    "createdAt": "2026-05-27T12:34:56.789Z"
  }
}