Verified Delivery Proof API

Programmatic proof that a delivery actually happened.

For every order SnapAct delivers, the platform records a cryptographically signed audit trail — KYC-verified rider, GPS pickup, GPS drop, buyer-confirmed handoff phrase. Insurers, lenders, FMCG distribution auditors, and marketplaces consume these proof records by API.

KYC-cleared riders GPS pickup & drop Signed audit trail Webhook events
Order #a3f7b2c1 delivered in Ikoyi Just now · KYC-Gold rider · 4-word phrase verified · 12 min total
Verified
KYC Every rider passes NIN, BVN, bond, guarantor, and next-of-kin verification
GPS Lat/lng recorded at pickup and drop, immutable on the audit ledger
Phrase Buyer-held 4-word secret confirms the handoff cryptographically
Signed Every API response and webhook signed HMAC-SHA256 for tamper detection

Why it matters

"It was delivered" should be a fact, not a claim.

Cards-on-delivery, BNPL fulfilment, FMCG distribution audits, and B2B supplier-to-retailer movement all rely on someone trusting "yes, it arrived." SnapAct turns that trust into a verifiable record — multi-signal, signed, and queryable.

For insurers

Cargo, parcel, and last-mile insurance claims hinge on proof of delivery. SnapAct provides claim-grade signed evidence in one API call.

For lenders

BNPL and inventory-financing decisions need post-disbursement proof the goods reached the borrower. Delivery Proof closes the audit loop.

For FMCG & distributors

Distribution audits, secondary-sales verification, and trade-marketing rebate validation — proof your products moved from depot to retailer to consumer.

API surface

One signed call. One webhook stream. Every state on the audit trail.

Approved integrators get a Trust API key with the delivery_v1_proof scope. Query a specific delivery by escrow ID, or subscribe to a webhook stream for delivery state transitions.

GET/v1/delivery/{escrow_id}

Returns the signed delivery record — rider trust signals, GPS pickup & drop, timing, buyer phrase verification result.

HOOKdelivery.dispatched

Fires when a rider accepts an offer. Carries the rider's anonymized trust signals + estimated delivery window.

HOOKdelivery.picked_up

Fires when the rider confirms physical pickup at the partner location. Includes pickup timestamp + GPS.

HOOKdelivery.confirmed

Fires the moment the buyer's handoff phrase matches at drop-off. Includes drop GPS, total time, signed proof token.

api.trust.snapact.io Live
GET /v1/delivery/snapact_escrow_a3f7b2c1-...
Authorization: Bearer $SNAPACT_TRUST_API_KEY

Response (200):
{
  "escrow_id": "snapact_escrow_a3f7b2c1-...",
  "status": "DELIVERY_CONFIRMED",
  "rider": {
    "kyc_tier": "gold",
    "bond_posted": true,
    "acceptance_rate": 0.94
  },
  "pickup": {
    "at": "2026-05-16T14:02:11Z",
    "lat": 6.4474,
    "lng": 3.4737
  },
  "drop": {
    "at": "2026-05-16T14:14:38Z",
    "lat": 6.4541,
    "lng": 3.4061,
    "phrase_match": true
  },
  "signed_at": "2026-05-16T14:14:39Z",
  "signature": "v1=4a8f..."
}

What's verifiable

The signals that make this proof reliable.

Every delivery on SnapAct contributes multiple independent signals to the proof record. Any one signal is forgeable in isolation; the combination is not.

Rider identity NIN, BVN, bond receipt, guarantor & next-of-kin records — checked at onboarding, re-checked on suspension events.
GPS continuity Live-location stream during shift, plus discrete pickup and drop timestamps recorded server-side.
Buyer phrase 4-word phrase generated server-side at order time, shown only to the buyer in the SnapAct mobile app, verified at drop-off.
Audit trail Every state change written append-only to the SnapAct audit ledger — immutable, query-able by approved integrators.

Built for trust

Why the proof is worth licensing.

Delivery proof is only valuable to the parties downstream if the chain of custody is honest. Every link is designed for that.

Multi-signal verification

Rider identity, GPS, buyer phrase, and admin audit trail must all agree. No single party can falsify a delivery alone.

Immutable audit ledger

State transitions are append-only. Even SnapAct ops cannot modify a confirmed delivery record retroactively — only correct via a new audit entry.

HMAC-signed responses

Every API response and webhook carries an HMAC-SHA256 signature over canonical fields. Integrators can re-verify proof records months after receipt.

Early access

Building something that needs verifiable delivery?

Insurer, lender, brand, distributor, or marketplace — request a sandbox key and integrate against the SnapAct delivery audit trail. Pilot terms include 90 days free + named integration support.