Make a complete test order

This path exercises the real integration sequence without touching your live wallet.

Before you begin

A verified Shioja merchant account
One application created in the Shioja dashboard
A funded test wallet
A server where your secret key can be stored safely

1. Get your test keys

Each application receives four credentials. Use test_pk for catalogue reads and test_sk for quotes, orders, wallet data, and order data. A key determines both the application and environment; you do not send a separate app ID or mode.

2. Read products

Fetch a small page and keep the returned product id. Product prices are returned for the environment represented by your key.

3. Build a version 2 address

Populate selectors in order: states, then LGAs for the chosen state, then towns for the chosen state and LGA. Send the exact values returned by these endpoints.

States→LGAs→Towns→Quote

4. Quote delivery

A quote validates the product and address, calculates delivery, snapshots the price, and expires after 15 minutes. Create it with your test secret key.

5. Create the order

Send the returned quoteId with a unique checkout reference. Keep the same idempotency key when retrying a timeout. Shioja will return the original order instead of charging twice.

6. Go live

Repeat your automated tests using live_pk and live_sk in a controlled environment. Verify your live wallet, webhook URL, order display, retry behavior, and support process before opening production traffic.