How it works
01
Buyer creates deal
Enters delivery address, selects courier, and pays into escrow. Seller is notified instantly.
02
Seller ships with partner courier
GIGL, Kwik, Sendbox, or any integrated provider. Tracking ID is linked to the deal.
03
Courier confirms delivery
A signed webhook fires when the parcel is delivered. We verify the HMAC signature before processing.
04
72-hour window opens
Buyer can inspect and raise a dispute. After 72 hours of silence, funds release automatically to seller.
// DELIVERY WEBHOOK EVENT
{
"event": "delivery.confirmed",
"provider": "GIGL",
"tracking_id": "GIGL-4821-NG",
"deal_id": "deal_DLV9921",
"delivered_at": "2025-09-14T14:30:00Z",
"signature": "sha256=a8f3c...",
"verified": true,
"state_transition": {
"from": "IN_TRANSIT",
"to": "AWAITING_CONFIRMATION"
}
}✓ HMAC verified
Every courier webhook is verified against the provider's HMAC key before touching our state machine. Forged events are rejected at the ingress middleware.