Skip to main content
Payments are asynchronous. Creating one returns 202 Accepted straight away, while the customer approves the prompt or the bank confirms. Cloudpay doesn’t send webhooks yet, so poll the payment.

Collections and payouts

completed and failed are final, so a payment never leaves them.

Polling

An M-Pesa prompt expires on the customer’s phone after about a minute. Bank payouts can take longer. Poll from a background job, not inside a web request.

Settlements

Batches

GET /v1/merchants/{id}/bulk/{batchID} returns item counts by status. To list the items themselves, add ?batch_id= to the collections or disbursements list. Each item follows the same lifecycle as a single payment.