Orders
Product price plus delivery fee is deducted atomically when an order is created.
Test, live, and wallets
The key prefix is the environment switch. Test and live activity use separate balances and usage records.
Environment selection
test_* keys use the test wallet and mark created orders as test. live_* keys use real merchant funds and create live orders. Request bodies do not override the mode chosen by the key.
What is charged
Product reads
Returned product records are counted during the day and settled in one wallet entry.
Product-read settlement
Catalogue calls do not update the wallet inside the product request. Usage is aggregated by day and mode, then the previous day's product reads are settled at 1:00 AM Africa/Lagos. This keeps product browsing responsive and reduces transaction contention.
Balance safety
Order creation reads and updates the financial summary in the same transaction as the order and wallet entry. An insufficient balance returns an error without creating an order. Idempotency protects retries from a second deduction.
Go-live checklist
- Fund the live wallet
- Replace every test key with the matching live key in server configuration
- Run a controlled low-value live order
- Verify order, wallet entry, delivery status, and webhook processing
- Keep test and live logs visibly separated