Idempotency

How partnerId prevents duplicate orders.

partnerId is your own unique reference for an order. It is also how the API prevents duplicate orders.

You sendYou get
A partnerId you have not used beforeA new order
A partnerId you have already used400 with PARTNER_ID_ALREADY_USED. No second order is created

How to use it

  1. Generate the partnerId and store it before you call Create Order.
  2. If the request times out or returns 500, send it again with the same partnerId. Either the order is created, or you get PARTNER_ID_ALREADY_USED, which tells you the first attempt went through. In that case, find the order with List Orders.
  3. If an order fails and you want to try again, create a new order with a new partnerId.

A pattern that helps later

Give the orders of one batch a shared prefix, such as payroll-2026-11-001, payroll-2026-11-002. It makes a batch easy to recognize in List Orders and in reports.