ZapAPI Docs
Get StartedConceptsAI GatewayGuidesPayment GatewaySDKAPI ReferenceResources
ApiPayment links

Create a new payment link (creates real LNURL-pay link on LNbits)

POST
/api/v1/payment-links

Authorization

bearer

Header Parameters

X-API-Version?string

API version for header-based versioning

Default"1"
Value in"1""2"

Request Body

application/json
  1. body
description*string

Payment link description

type*string

Payment type

Value in"fixed""flexible"
amount?number

Fixed amount in satoshis (required if type is fixed)

minAmount?number

Minimum amount in satoshis (if type is flexible)

maxAmount?number

Maximum amount in satoshis (if type is flexible)

collectEmail*boolean

Collect customer email

Defaultfalse
collectName*boolean

Collect customer name

Defaultfalse
expiresAt?string

Expiration date (ISO 8601)

projectId?string

Associated project ID (optional for quick links)

providerId?string

Provider ID to use for payments (optional - falls back to default/platform)

isQuickLink?boolean

Whether this is a quick link (personal use, no project)

Defaultfalse
commentChars?number

Allow comments on the payment page (max comment chars)

Response Body

Payment link created successfully

Example Request
curl -X POST 'http://localhost:3001/api/v1/payment-links' \  -H 'Content-Type: application/json' \  -d '{  "description": "Premium Subscription - Monthly",  "type": "fixed",  "collectEmail": false,  "collectName": false}'
Example Response201
Empty