Confirm order (POS - legacy)

Once seQura approves the order, your shop must confirm it's actually being placed. Since POS software runs in an isolated environment where seQura can't send an IPN, you must start the process manually.

Contact seQura to activate this option—it's not available by default.

Overview

When the shopper notifies you the credit has been approved, the store operator must proceed with confirmation.

Configuration

For manual IPN workflow, don't include any URLs in the payload: no notify_url, return_url, or approved_url.

Completing the confirmation

To complete confirmation:

  1. Send order data to seQura for verification.
  2. Mark the order as completed in your database.
  3. Send the order reference to seQura (if not already done).

In step 1, make a PUT request to the URL from the initial solicitation's Location header. Include all order data plus state="confirmed".

seQura usually responds with 200 OK, so proceed with steps 2-3. But if the cart, delivery address, or other details changed unacceptably, seQura responds with 409 Conflict and a JSON body explaining the issues. In this case, don't complete the order or send the order reference.

After steps 1 and 3 return 200 OK, the order is confirmed. You can proceed with delivery and payment receipt. seQura emails the shopper the credit conditions.

Problem: Order reference missing

seQura can't process an order or pay you until you provide order_ref_1. We follow up weekly on confirmed orders missing this reference. Recurring issues may lead to service disconnection.

Problem: Order reference not unique

seQura requires (merchant.id, merchant_reference.order_ref_1) to be unique for confirmed orders. Duplicate references won't be processed. This error can occur in two places:

  • During step 1, when confirming the order. If you provided order_ref_1 at checkout start, seQura checks uniqueness and responds with 409 Conflict if not unique.
  • During step 3, when updating the confirmed order with the reference. seQura responds with 409 Conflict if not unique. This is more complex: the order is confirmed with seQura as payment method, but seQura can't process it further.