Skip to content

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 checkoutPayment link
ForA shop or app with a price per orderA page people can pay
You needA server and a secret keyA signed-in hub account
AmountFixed by your serverOpen, or a suggestion the payer can change
ConfirmGET /checkouts/:idThe pocket in the hub
DocsThis sitePayment links

How a hosted checkout works ​

  1. Create the checkout on your server. The browser never holds the secret key or the amount.
  2. The return URL is a hint. Call GET /checkouts/:id before you fulfill.
  3. The payment goes to the account that owns the key, into its main pocket.

What is live ​

AreaState
Create and retrieve checkoutsLive
Hosted page, mobile moneyLive
M-Pesa Pay Bill on a Kenya checkoutLive when that deployment has Pay Bill on
Card on the hosted pageLive when that deployment has the card rail on
API keys (one per account)Live. Hub: API Integrations, Keys
Payment linksLive. Created in the hub
WebhooksNot sent. The hub tabs are placeholders
Refunds, list checkouts, test-mode switchNot offered

These pages describe staging

Production hosts are not listed. Staging charges a real phone. See Environments.

Next ​

Staging documentation. Staging charges real money. See Environments.