API-first, not API-eventually.

Every wholesale-specific entity in Mercantyl is a first-class REST resource: buyer accounts, contract pricing, NET terms, RFQs, the pricing engine, webhooks. If you can do it in the admin panel, you can do it from a script.

Quickstart

Authenticate with your API key, fetch your products, list a buyer account, submit an order. Five requests.

Authenticate

curl https://api.mercantyl.co/v1/auth/whoami \
  -H "Authorization: Bearer mck_live_..."

# {"account_id":"acc_01HF...","plan":"professional","api_version":"v1"}

List products

curl https://api.mercantyl.co/v1/products?limit=20 \
  -H "Authorization: Bearer mck_live_..."

# {
#   "data": [
#     {
#       "id": "prd_01HF...",
#       "sku": "TRAY-AL-001",
#       "name": "Aluminum Rolling Tray",
#       "variants": [...],
#       "tier_pricing": [{"min_qty": 1, "price_cents": 4200}, ...]
#     }
#   ],
#   "has_more": true,
#   "next_cursor": "..."
# }

Create a buyer account

curl https://api.mercantyl.co/v1/buyers \
  -H "Authorization: Bearer mck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Northline Supply Co.",
    "primary_contact": {"email": "buyer@pacificmerchants.com"},
    "credit_limit_cents": 5000000,
    "net_terms": "net_60",
    "tier": "premium"
  }'

Submit an order on behalf of a buyer

curl https://api.mercantyl.co/v1/orders \
  -H "Authorization: Bearer mck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "buyer_id": "buy_01HF...",
    "line_items": [
      {"product_id": "prd_01HF...", "variant_id": "var_01HF...", "quantity": 500}
    ],
    "shipping_address_id": "adr_01HF...",
    "payment_method": "net_60"
  }'

Subscribe to a webhook

curl https://api.mercantyl.co/v1/webhooks \
  -H "Authorization: Bearer mck_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://yourapp.example/webhooks/mercantyl",
    "events": ["order.created", "order.paid", "quote.requested"],
    "signing_secret": "whsec_..."
  }'

API resources

Rate limits & guarantees

Authentication