Payment Request API
Create payment requests programmatically with a single API call. REST API + signed webhooks. iDEAL, SEPA, cards, Apple Pay, Klarna and PayPal — one endpoint, every provider.
POST https://api.payrequest.app/v1/payment-requests
Authorization: Bearer pk_live_xxx
Content-Type: application/json
{
"customer": {
"email": "[email protected]",
"name": "Jane Doe"
},
"amount": 750.00,
"currency": "EUR",
"description": "Website redesign — Phase 1 deposit",
"due_date": "2026-06-01",
"delivery": ["email", "sms"],
"reminders": {
"enabled": true,
"cadence": "every_2_days",
"max": 5
}
}Everything you need to embed payments
Built for SaaS, hosting, agencies and product teams.
OpenAPI spec
Full machine-readable specification. Generate SDKs for any language with one command.
Signed webhooks
HMAC-SHA256 signed events for payments, refunds, subscriptions, customer changes — verify authenticity in milliseconds.
One endpoint, every provider
Same API whether the customer pays via Stripe, Mollie or PayPal. Switch providers without changing your integration.
Bearer token auth
Live and test API keys with scoped permissions. Rotate keys instantly from the dashboard without downtime.
Idempotency keys
Safe to retry. Pass an Idempotency-Key header and we deduplicate at the API level — no duplicate charges.
Rate limits that scale
100 requests/min on Free, scaling automatically with payment volume. No quotas, no surprise throttling.
Response — 201 Created
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "pr_8f3k2j9d1xQ",
"url": "https://pay.payrequest.io/your-studio/8f3k2j9d1xQ",
"status": "sent",
"amount": 750.00,
"currency": "EUR",
"customer": {
"id": "cus_a1b2c3d4",
"email": "[email protected]"
},
"created_at": "2026-05-11T10:23:11Z",
"expires_at": null
}The response gives you a unique payment URL to share, plus IDs to reference the request later.
Webhook — payment.succeeded
POST https://your-app.example.com/webhooks/payrequest
X-PayRequest-Signature: sha256=...
Content-Type: application/json
{
"id": "evt_92Kx7s3pQrL",
"type": "payment.succeeded",
"created_at": "2026-05-11T11:48:02Z",
"data": {
"payment_request_id": "pr_8f3k2j9d1xQ",
"amount": 750.00,
"currency": "EUR",
"method": "ideal",
"provider": "mollie",
"customer_id": "cus_a1b2c3d4"
}
}Subscribe to events your app cares about. Each delivery is signed and retried with exponential backoff.
Built for these integrations
SaaS billing
Auto-generate payment requests when a customer hits a usage tier, upgrades a plan, or pays an overage fee.
Hosting providers
Bill clients automatically when subscriptions renew. Listen to payment.failed and trigger account suspension flows.
Agency CRM
When a deal closes, fire a payment request from your CRM. Sync paid status back via webhook.
Marketplace platforms
Issue split payments between vendors. PayRequest routes funds to your connected provider's payouts system.
Developer FAQ
Does PayRequest have a payment request API?
+
Yes. PayRequest exposes a REST API to create payment requests, manage customers, send via any delivery channel, and listen for events via webhooks. The API is OpenAPI-spec'd and authenticated via Bearer tokens. Full reference at docs.payreque.st.
How do I create a payment request via API?
+
POST to /v1/payment-requests with the customer's email, amount, currency and description. The response includes a unique payment URL you can share, plus IDs to track the request. Optional fields let you set due dates, automatic reminders, custom branding and delivery channels.
What webhooks does PayRequest support?
+
PayRequest fires webhooks for every important event: payment.succeeded, payment.failed, payment_request.viewed, payment_request.reminded, customer.created, subscription.activated, refund.created. All webhooks are signed with HMAC-SHA256 so you can verify authenticity.
Is the PayRequest API free to use?
+
Yes. API access is included on the Free plan with no monthly fee. You only pay 2% per successful payment (capped at €25 per transaction) plus your provider's processing rate. Rate limits are generous and scale with your usage.
Which payment providers does the API support?
+
The API routes through your connected provider — Stripe, Mollie, PayPal or any combination. Set the provider at the account level or per-request. The same /v1/payment-requests endpoint works regardless of provider; we abstract the differences.
Get your API key in 30 seconds
Free to start. Test keys + sandbox out of the box. Ship your integration in a day.