How Seller API fits Shopify, WooCommerce, Magento, BigCommerce, and custom keyshops — plus the Steam/Epic boundary.
What this covers#
Where to put Avrix calls in common commerce stacks. Pair with Architecture patterns and Store integration profiles.
Hard rule#
Checkout UI talks to your backend. Your backend calls Avrix with the Seller API key. Never embed the key in themes, storefront JS, or app clients.
Platform sketches#
Shopify#
Use a Shopify app (or private app backend) that receives order / payment
webhooks, then runs preview → charge confirmation → POST /orders on your
server. Theme code must not hold AVRIX_API_KEY.
WooCommerce / Magento#
Implement a PHP plugin or module that hooks after successful payment at
your PSP. Call Avrix from the server plugin (Guzzle). Persist orderReference
as the Woo/Magento order id (or a stable derived id).
BigCommerce#
Same pattern: server-side app or middleware after payment capture. Sync catalog on a schedule; do not scrape the storefront for SKU authority — use Avrix snapshot + allocations.
Custom keyshop#
You own cart, tax, and PSP. Recommended flow:
Steam / Epic#
Steamworks and Epic Online Services are separate platform contracts. Avrix does not create Steam packages or Epic store offers. Use Avrix for inventory you sell through your commerce channels; use each platform’s APIs for sales inside that platform’s store.
Mapping store concepts#
| Your concept | Avrix field / API |
|---|---|
| SKU / product code | skuCode on preview and orders |
| Store order id | orderReference |
| Buyer country | countryCode / sales country in order context |
| Payment id | paymentProcessorReference (opaque) |
| Fulfilment email job | Triggered after order response or webhook |
Common mistakes#
- Calling Avrix from Shopify Liquid or Woo storefront JS.
- Using a new idempotency key on every PSP webhook retry.
- Syncing only
/productsand skipping/allocations— see Sellable SKU readiness.
Next steps#
- Creating orders — safe commit pattern
- Integration recipes — scopes and call order
- FAQ — short answers to common questions