- Prompt a phone (
charge): an M-Pesa or Airtel Money prompt, fully server side. The payer never sees Paystack. - Take a card (
checkout): a Paystack payment page for cards and mobile money.
Turn it on
Settings → Rails → Collection → Paystack, and choose the mode:Collect
provider: "paystack" and method: "charge" or "checkout". For a card page, send the payer to checkout_url. Then poll or listen with webhooks. Paystack gives the payer about 180 seconds to approve a prompt.
T-Kash isn’t on Paystack: network: "tkash" returns 400 network_unsupported.
Cloudpay’s account or your own
Using your own keys
1
Add your keys
Settings → Rails → Your own provider keys → Paystack → Use your own keys: your secret key and public key from Paystack’s dashboard (Settings → API Keys & Webhooks). Use
sk_live_ / pk_live_ keys: Production refuses test keys. Keys are stored encrypted and never shown again.2
Paste Cloudpay's webhook URL into Paystack
Copy the Paystack address from Settings → Webhooks → Cloudpay IPN addresses (or In Paystack: Settings → API Keys & Webhooks → Live Webhook URL, paste it, and save.
GET /v1/merchants/{id}/ipn-urls), for example:3
Send one small live payment
Prompt your own phone for KES 10 and check it’s
completed.In Development
Development (sk_test_ Cloudpay keys) always uses Cloudpay’s own provider accounts, whatever keys you’ve added, with real prompts up to KES 100. Your own Paystack keys take effect in Production.