Issue a recipient code for a delivery

POST 
/v2/pod/issue

Optional first step of Proof of Delivery. Generates a 6-digit recipient code bound to your order_ref + destination, and returns it so you can deliver it to the recipient over your own channel (SMS/app). The courier later submits it at /v2/pod/confirm. AfriHex does not store your shipment — only the proof event.

Request

Responses

201

Code issued

400

Missing/invalid fields

429

Rate limit exceeded

Response Headers

X-RateLimit-Limit

Maximum requests allowed in the window

X-RateLimit-Remaining

Requests remaining in current window

Retry-After

Seconds until the rate limit resets