Delivery and SMS

Delivery and SMS

GET /payouts/{reference}/delivery → { "pin": "1234", "serial": "EXAMPLE-SERIAL", "instructions": null }

• Standard Bank Instant Money, Nedbank Cardless: PIN + serial available here; resend-sms supported (provider caps resends, 30-minute cooldown → RATE_LIMITED).

• RTC EFT: no codes — it is a bank credit; resend-sms returns METHOD_UNAVAILABLE.

• Voucher methods return pin, serial, nullable expires_at, and nullable instructions. The vendor sends the PIN to the recipient. No provider SMS exists; resend-sms returns METHOD_UNAVAILABLE. Delivery reads require payouts:delivery, are audited, and only succeed when paid.

Access and responses

Delivery requires payouts:delivery and is available only for paid payouts. Collection codes are sensitive; restrict access to the recipient and authorised staff. The delivery endpoint wraps the delivery object in {"success":true,"data":{...}}.

POST /api/v1/payouts/{reference}/resend-sms requires payouts:write. It requests another delivery SMS without making another payout. A successful response is {"success":true,"data":null}. See fixed errors for unavailable methods and resend limits.

Delivery fields

Field	Type	Values
pin	string or null	—
serial	string or null	—
instructions	string or null	—
expires_at	string or null	—