Payment Links API
Create a payment link
POST /v1/payment-links
Creates a new payment link and returns a checkout URL.
Request headers
X-API-Key: brykto_live_sk_...
Content-Type: application/json
Request body
{
"amount": "49.99",
"currency": "USD",
"description": "Order #1234",
"customer_email": "customer@example.com"
}
| Field | Type | Required | Description |
|---|---|---|---|
amount |
string | Yes | The payment amount |
currency |
string | Yes | ISO 4217 currency code (USD, EUR, NZD, etc.) or XRP/XLM for native mode |
description |
string | No | A short description shown on the payment page |
customer_email |
string | No | Pre-filled for customer receipt |
Response
{
"request_id": "pr_abc123",
"checkout_url": "https://bryktopay.com/pay/pr_abc123",
"amount": "49.99",
"currency": "USD",
"status": "pending",
"expires_at": "2026-08-15T00:00:00"
}
Payment link expiry
Payment links expire 7 days after creation if not paid. Expired links return status: "expired".