Wallet and disputes
Last updated July 30, 2026
Wallet balance
GET /wallet
{ "balance": 486562.5, "currency": "NGN", "environment": "sandbox" }
Transaction history
GET /wallet/transactions?page=&limit=
Each transaction has a type of funding, shipment_debit, refund, or adjustment, plus amount, balanceAfter, and a unique reference.
Sandbox wallets are pre-funded and cannot be topped up via the API. Production wallets are funded from the merchant dashboard, this is a dashboard-only action and isn't part of the public API surface.
Disputes
If something goes wrong with a shipment, whether it's damaged, lost, or delayed beyond what's acceptable, you can open a dispute directly against it.
POST /disputes
{ "shipmentId": "6890...", "reason": "Package arrived damaged, recipient refused delivery." }
Only one open dispute is allowed per shipment at a time.
GET /disputes?page=
GET /disputes/:id
Every dispute has a status of open, in_review, resolved, or closed, and a messages array recording the full back-and-forth between you and the 7feastr support team. When 7feastr responds to your dispute, you're notified in real time if you have a webhook subscribed to dispute events, and by email.