Branch collections

Let customers pay with cash at a branch.

Cash deposit is not available right now. Checkout does not offer cash, and a request for a new slip returns 409 with RAIL_UNAVAILABLE. Slips issued before cash was turned off stay valid until they are used or expire.

Cash-deposit slip

Give your customer one clear payment reference.

Create a deposit slip when your customer chooses cash deposit at checkout. If you retry the same request, Quid Payments returns the active slip instead of creating another one.

Create cash slip request

POST /api/v1/checkout/cash-slips
Content-Type: application/json

{
  "session_id": "cs_example",
  "amount_minor": 307038
}

Cash slip response

{
  "slip_token": "SLIP-ABC123DEF456",
  "reference": "s-cash-example",
  "amount_minor": 307038,
  "currency": "GHS",
  "invoice_ref": "INV-2026-001",
  "customer_name": "Ama Mensah",
  "status": "active",
  "expires_at": "2026-06-15T12:00:00Z",
  "replayed": true
}

Create a deposit slip

Hosted checkout keeps one active slip for the checkout.

Pay at the branch

Your customer presents the slip and payment details to the teller.

Wait for teller confirmation

The checkout stays pending while the teller confirms the deposit.

Update the order

Fulfil after a signed webhook or server-side lookup confirms success and the payment details match.

Send customers to hosted checkout

Use checkout_url to give your customer the right payment instructions.

Confirm the completed payment

Use a signed webhook or session lookup before you update the order.