Accept SavaPay payments in your checkout. SavaPay lets your business request a payment, send the customer to a secure SavaPay-hosted checkout page, and receive a confirmation when the payment is complete.
You never collect the customer's SavaPay password or approve the payment yourself. SavaPay handles approval in the hosted checkout, and the amount is locked server-side so it cannot be changed on the customer's screen.
Before you start
You need:
- A SavaPay merchant account.
- An API key for your server.
- A public web address where SavaPay can send payment updates (a webhook URL).
- A way to mark orders as paid in your own system.
How a payment works
Create
Your server creates a payment request for the exact order amount.
Approve
Your customer reviews and approves it in SavaPay-hosted checkout.
Notify
SavaPay sends your server a signed payment event.
Confirm
Your server checks final status, then completes the order.
Payment statuses
| Status | Meaning |
|---|---|
created | Intent stored; no customer interaction yet |
pending_customer | Checkout opened; awaiting customer approval |
processing | Customer approved; ledger move in progress |
succeeded | Customer debited, merchant credited |
failed | Approval could not complete (insufficient funds, frozen, fraud) |
expired | Checkout window elapsed without approval |
cancelled | Merchant cancelled an unpaid intent |
refunded | A succeeded payment was refunded |
Build for real-world conditions
Handle uncertain outcomes without creating a duplicate payment.
Launch safelyProduction readinessReview keys, payment safety, webhook reliability, and operations.
Stay compatibleAPI versioningUnderstand compatible improvements and future contract versions.
Start your integration
Start with the Quickstart learning example, then use the sandbox and production checklists to prepare your integration.
Start Integration