Outbound & sales

Sales ingest

Send orders, payments and refunds from your own website or app.

Endpoint

POST/api/sales/ingest

Create a Custom Website source in Sales to get its key (fos_live_…), then send it as Authorization: Bearer fos_live_….

Body

Amounts are in major units (2499 or "2499.00" for ₹2,499). Up to 500 records per request.

JSON

{
  "orders": [{
    "id": "ord_1001", "number": "1001", "createdAt": "2026-09-29T09:00:00Z",
    "currency": "INR", "total": 2499, "status": "paid",
    "customer": { "id": "cus_42", "email": "ana@acme.com", "name": "Ana" },
    "items": [{ "productId": "p_1", "name": "Sneakers", "sku": "SNK-1", "quantity": 1, "price": 2499 }],
    "paymentIds": ["pay_ABC"]
  }],
  "payments": [{ "id": "pay_ABC", "orderId": "ord_1001", "amount": 2499, "currency": "INR", "status": "captured", "method": "upi" }],
  "refunds": []
}