നിങ്ങളുടെ വെബ്‌സൈറ്റിൽ നിന്ന് ഓർഡറുകൾ അയക്കുക

Settings → Developers-ൽ API key ഉണ്ടാക്കുക. എല്ലാ request-ലും Authorization header-ൽ അത് ചേർക്കുക. Key ഒരു തവണ മാത്രം കാണിക്കും, plaintext-ൽ ഞങ്ങളുടെ servers-ൽ store ചെയ്യില്ല.

Authorization: Bearer om_live_xxxxxxxxxxxxxxxx

/v1/orders-ലേക്ക് order POST ചെയ്യുക. externalRef (നിങ്ങളുടെ order ID) നൽകുക — call idempotent ആകും, ഒരേ reference വീണ്ടും അയച്ചാൽ existing order ലഭിക്കും, duplicate ഉണ്ടാകില്ല.

curl -X POST https://api.ordermatrix.in/v1/orders \
  -H "Authorization: Bearer om_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "externalRef": "shop-order-1234",
    "customer": { "name": "Priya Sharma", "phone": "9876543210" },
    "address": { "line1": "12 MG Road", "city": "Bengaluru", "state": "Karnataka", "pincode": "560001" },
    "items": [{ "sku": "LIP-001", "name": "Red Lipstick", "price": 499, "qty": 2 }],
    "shipping": 50,
    "total": 1048,
    "paymentMethod": "prepaid",
    "paymentRef": "pay_abc123"
  }'

externalRef ഉപയോഗിച്ച് ഓർഡർ തിരിച്ചെടുക്കുക:

curl https://api.ordermatrix.in/v1/orders?externalRef=shop-order-1234 \
  -H "Authorization: Bearer om_live_your_key_here"

Settings → Developers-ൽ webhook URL ചേർക്കുക. ഓരോ സ്റ്റാറ്റസ് മാറ്റത്തിലും — shipped, delivered, cancelled — OrderMatrix നിങ്ങളുടെ endpoint-ലേക്ക് JSON പേലോഡ് POST ചെയ്യും. X-OM-Signature header പരിശോധിക്കുക.

{
  "event": "order.shipped",
  "orderId": "665f...",
  "orderNo": "ORD-2026-0042",
  "externalRef": "shop-order-1234",
  "status": "dispatched",
  "tracking": { "courier": "Delhivery", "awb": "1234567890" },
  "at": "2026-10-01T14:30:00.000Z"
}

const crypto = require('crypto');

function verifySignature(rawBody, receivedSig, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(rawBody)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(expected),
    Buffer.from(receivedSig),
  );
}

// Express example
app.post('/webhook', express.raw({ type: 'application/json' }), (req, res) => {
  const sig = req.headers['x-om-signature'];
  if (!verifySignature(req.body, sig, process.env.WEBHOOK_SECRET)) {
    return res.status(401).send('Unauthorized');
  }
  const event = JSON.parse(req.body);
  console.log(event.event, event.status);
  res.sendStatus(200);
});

Deliveries 3 തവണ retry ആകും — 0 s, 5 s, 30 s. നിങ്ങളുടെ endpoint 10 സെക്കൻഡിൽ 2xx return ചെയ്യണം.

നിങ്ങളുടെ store connect ചെയ്യാൻ തയ്യാറാണോ?

സൗജന്യ account ഉണ്ടാക്കുക, API key generate ചെയ്യുക, ആദ്യ order മിനിറ്റുകൾക്കുള്ളിൽ OrderMatrix-ൽ എത്തും.