Create a new pay link
POST/api/v1/stores/:storeId/payment-requests
Creates a reusable pay link that can be shared with customers to collect a Bitcoin payment.
Unlike invoices (which are single-use and expire), a pay link can be paid multiple times — each payment attempt generates a fresh BTCPay invoice behind the scenes.
Typical use cases
- Donations page with a fixed suggested amount
- Freelancer invoicing a client with a fixed EUR amount
- Subscription billing where you send a link each period
If expiryDate is omitted the link is valid for 30 days from creation.
Request
Responses
- 201
- 400
- 401
- 500
Payment request successfully created.
Bad request. Invalid input or unable to create the pay link.
Unauthorized.
Unexpected error.