Sales confirmation API
When your eCommerce order management system receives a sales event, your system should call the Usizy API to confirm the sale event as an HTTP POST, to the following URL: https://usizy.com/api/v2/event/confirm
Essential variables
The following variables should be included into your call:
api_key
Clients should authenticate by passing the api key in the “Authorization” HTTP header, prepended with the string “Api-Key “.
For example:
Authorization: Api-Key 401f7ac837da42b97f
Please contact Usizy to confirm the specific api_key that should be included within this variable.
The same API key will work for the confirmation, cancellation, or returns integration.
order_id
Unique order identifier
product_ids
List of purchased product_ids. (this ID must be the same reference as the “data-unique-product-id” variable included in your product feed, and the “data-product” variable in the Size Adviser API call on your product pages).
If more than one product was purchased within a single order, the list must include each individual product purchased within that specific order, separated by commas (“,”).
variation_ids
List of purchased variation_ids (SKUs). If more than one product was purchased within a single order, you must include a comma-separated list of variations, for each product purchased within that specific order.
sizes
List of purchased product sizes. If more than one product was purchased within a single order, you must include a comma-separated list of sizes, for each product purchased within that specific order.
sizes_system
List of purchased product size systems. If more than one product was purchased within a single order, you must include a comma-separated list of size systems, for each product purchased within that specific order.
Recommended variables
currency
Currency used in the order.
prices_vat
List of purchased product prices with taxes. If more than one product was purchased within a single order, you must include a comma-separated list of prices with tax, for each product purchased within that specific order.
prices_no_vat
List of purchased product prices without taxes. If more than one product was purchased within a single order, you must include a comma-separated list of prices without taxes, for each product purchased within that specific order.
total_vat
Total basket amount with tax, excluding shipping costs.
total_no_vat
Total basket amount without tax, excluding shipping costs.
shipping_cost
Total order shipping cost.
OpenAPI documentation
An OpenAPI spec with a developer-oriented documentation is available through the following link