Easy Labs
APIPaymentsPayment link

Create a payment link

Create a payment link

POST
/v1/api/payment-link/
x-easy-api-key<token>

Merchant API key. Publishable keys (pk_test_* / pk_live_) are safe for browser/frontend use and carry a limited scope set (sessions, payment_instruments, customers, orders writes; products, product_prices, payment_links reads). Secret keys (sk_test_ / sk_live_*) grant full admin access and must only be used server-side.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://loading/v1/api/payment-link/" \  -H "Content-Type: application/json" \  -d '{    "nickname": "Premium Widget Payment",    "amount_type": "FIXED",    "products": [      {        "id": "prod_abc123",        "product_prices": [          {            "id": "price_abc123",            "quantity": 1,            "adjustable": false          }        ]      }    ],    "allowed_payment_methods": [      "PAYMENT_CARD"    ],    "collect_buyer_details": "email",    "additional_details": {      "terms_of_service_url": "https://example.com/terms"    }  }'
{
  "success": true,
  "timestamp": "2026-02-06T12:00:00.000Z",
  "message": "Payment link created",
  "data": {
    "id": "pl_abc123",
    "url": "https://pay.example.com/pl_abc123",
    "amount_cents": 5000,
    "currency": "USD",
    "status": "ACTIVE",
    "created_at": "2026-02-06T12:00:00.000Z"
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}
{
  "success": false,
  "timestamp": "2019-08-24T14:15:22Z",
  "error": {
    "code": "string",
    "message": "string",
    "details": null
  }
}