Public beta
Recipe: Refund on cancellation
When your customer cancels an order in your storefront, you should cancel the Zippex delivery and refund their payment in your own payments stack.
Cancellation windows
- Free while status is
createdorpending. - Partial fee once a driver has accepted (status
driver_assigned). - Full fee after pickup.
Step 1 — Cancel the delivery
curl -X POST https:"color:#6a9955">//api.zippex.com/v1/deliveries/del_m8n9o0p1/cancel \
-H "Authorization: Bearer zx_test_abc123def456"Step 2 — Refund the customer
Zippex bills your account for delivery; we never charge the end customer. Your refund logic stays in your own payments processor (Stripe, Square, etc.). Match Zippex’s cancellation fee against your service fee policy and refund the rest.
Handle 409 cleanly
If the cancel call returns
409 Conflict the delivery is already in motion. Notify the customer that their order is on the way and offer to redirect or hold at the destination instead.