How partnerId prevents duplicate orders.
partnerId is your own unique reference for an order. It is also how the API prevents duplicate orders.
| You send | You get |
|---|---|
A partnerId you have not used before | A new order |
A partnerId you have already used | 400 with PARTNER_ID_ALREADY_USED. No second order is created |
How to use it
- Generate the
partnerIdand store it before you call Create Order. - If the request times out or returns
500, send it again with the samepartnerId. Either the order is created, or you getPARTNER_ID_ALREADY_USED, which tells you the first attempt went through. In that case, find the order with List Orders. - 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.