Appearance
Overview
Use a hosted checkout when your server knows the price of each order. Use a payment link when you want a page people can pay, with no server.
| Hosted checkout | Payment link | |
|---|---|---|
| For | A shop or app with a price per order | A page people can pay |
| You need | A server and a secret key | A signed-in hub account |
| Amount | Fixed by your server | Open, or a suggestion the payer can change |
| Confirm | GET /checkouts/:id | The pocket in the hub |
| Docs | This site | Payment links |
How a hosted checkout works
- Create the checkout on your server. The browser never holds the secret key or the amount.
- The return URL is a hint. Call
GET /checkouts/:idbefore you fulfill. - The payment goes to the account that owns the key, into its
mainpocket.
What is live
| Area | State |
|---|---|
| Create and retrieve checkouts | Live |
| Hosted page, mobile money | Live |
| M-Pesa Pay Bill on a Kenya checkout | Live when that deployment has Pay Bill on |
| Card on the hosted page | Live when that deployment has the card rail on |
| API keys (one per account) | Live. Hub: API Integrations, Keys |
| Payment links | Live. Created in the hub |
| Webhooks | Not sent. The hub tabs are placeholders |
| Refunds, list checkouts, test-mode switch | Not offered |
These pages describe staging
Production hosts are not listed. Staging charges a real phone. See Environments.
Next
- Quickstart
- Kahawa, a shop on Cloudflare Pages
- Create a checkout