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 and delivery preview reads and test_sk for 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→Fee preview

4. Preview delivery

Use the product and selected state, LGA, and town to show the customer an estimated delivery fee.

5. Create the order

Send the product, full delivery address, customer details, and a unique checkout reference. Shioja recalculates delivery on the server. Keep the same idempotency key when retrying a timeout.

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.