Skip to main content

Testing

Build and test your integration against the sandbox. It runs the same code and the same order/payment flow as production, with test money only.

https://sandbox.sevi.io/graphql

Get a sandbox account​

Email tech@sevi.io and ask for a sandbox seller account. You will get access to the staging seller dashboard, where you generate a sandbox API token and set up your sandbox webhooks.

To act as the buyer (pay orders, confirm delivery in the app) you can get the staging build of the Sevi mobile app — see Mobile.

Test the full flow​

Walk through every step of the Integration flow at least once:

  1. orderCreate → store order.id, referenceNumber and paymentLink.
  2. Open the paymentLink and pay as the buyer.
  3. Check you receive the ORDER webhook with AWAITING_SHIPMENT / PAID.
  4. Call orderDeliver → check the ORDER webhook with DELIVERED and deliveryConfirmedBy: "SELLER", and the TRANSACTION webhook (TOP_UP, COMPLETED, hold.wasHeld: true).
  5. Repeat with the buyer confirming delivery in the app instead → deliveryConfirmedBy: "BUYER"; then call orderDeliver anyway and check it is a harmless no-op.
  6. Also test: an order you cancel with orderCancel, calling orderDeliver before payment (must be rejected), a partial delivery (orderDeliver with amount), and your webhook endpoint returning an error (Sevi retries).

Going live​

Switch the endpoint to https://partner.sevi.io/graphql, use your production API token, and configure the production webhooks in admin.sevi.io. Nothing else changes.