---
title: "/orders/associate"
method: POST
path: "/orders/associate"
---

# /orders/associate

`POST /orders/associate`

Sandbox (Testing): https://gateway.sand.us.zip.co/orders/associate

Associates a merchant's unique order ID with an order after creation.  This endpoint can be used to tie the Merchant Reference that is passed into Zip when checkout is initiated with a differently formatted ID on the merchant side, once the order is created.

## Headers

- `QP-Territory` string, required

## Request body

- object
  - `merchantReference` string — Gets or sets the merchant's reference number of the order
  - `merchantPlatformId` string — Gets or sets the ID to associate to the order
  - `orderId` string — Gets or sets the OrderId of the order to look up
  - `lineItems` object[] — Gets or sets the line items to add to the order
    - `description` string — Gets or sets a description about the item being purchased.
    - `name` string — Gets or sets the name of the item being purchased.
    - `quantity` integer — Gets or sets the quantity of the items being purchased.
    - `price` number, double — Gets or sets the price of a single item.
    - `sku` string — Gets or sets the SKU identifier of the item being purchased.
    - `isPreOrder` boolean — Gets or sets the flag indicating whether or not this item will be included in a preorder
    - `releaseDate` string, date — Gets or sets the date a preorder order will be shipped

## Response `204`

204

- object

---

[API](https://skmtc.dev/zip/apis/gateway-api.md) · [All operations](https://skmtc.dev/zip/apis/gateway-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zip/gateway-api/revisions/4b1127fdca1e/schema)