Order Flow

Understand why orders are created first and confirmed separately, and the difference between Resolve and Confirm endpoints.

Orders in Relograde are intentionally a two-step process. Creating an order does not charge your balance or deliver any vouchers, it is a price and availability check. Only when you confirm or resolve the order does payment and fulfillment happen.

The full flow

Create order - POST /order

Submit a list of products and your preferred payment currency. Relograde checks availability and locks in pricing. The response includes a trx identifier and the full cost breakdown. The orderStatus is created and your balance remains untouched.

Review the response

Inspect priceInclVat, per-line status, and allowAsyncDelivery flags before proceeding. If anything is unexpected, cancel now, no charge applies.

Confirm or Resolve - PATCH /order/confirm/{trx} or PATCH /order/resolve/{trx}

Your balance is debited and fulfillment begins. Choose the endpoint based on your delivery requirements (see below).

Confirm vs. Resolve

Both endpoints finalize an order, but they use different processing logic.

	Confirm	Resolve
Processing	Batch, all orders treated equally	Immediate, max one order at a time
Response if slow	Returns `pending`, delivers later	Cancels automatically after 30s
Async delivery	Yes	No
Best for	Bulk orders, latency-tolerant systems	Webshops, POS, real-time delivery, handling single orders

Confirm

Use Confirm for bulk ordering or any system where delivery latency is not critical. Orders are processed in batches with no priority distinction between customers. If fulfillment is not completed immediately, the order returns with status pending and delivery continues in the background.
Call Find order or use a webhook to detect when orderStatus reaches finished.

Resolve

Use Resolve for real-time delivery systems such as webshops or point-of-sale integrations. This endpoint bypasses batch processing and fulfills the order immediately. You are guaranteed a response within 30 seconds, if fulfillment cannot complete within 30 seconds, the order is automatically cancelled and no charge is applied.

One order limit

Resolve processes one order at a time.

Cancellation

You can cancel an order at any point:

Before confirming: the order is deleted entirely (204 No Content). No charge.
After confirming: the order is marked cancelled and a partial or full refund may apply depending on which lines were already delivered.

Deleted orders cannot be retrieved

If cancelled before confirming, the trx is gone. Find order will return 404 for deleted orders.

Order statuses

Status	Meaning
`created`	Order created, not yet confirmed
`pending`	Confirmed, fulfillment in progress
`finished`	Fully delivered
`cancelled`	Confirmed then cancelled
`deleted`	Cancelled before confirmation