Orders & Checkout API

Create, manage, and automate consumer checkout orders with localized Indian payment methods (UPI Intent, QR, COD) and instant webhook triggers.

POSThttps://api.ecomify.io/v1/orders

Overview

The /v1/orders endpoint is the heart of headless commerce on Ecomify. It handles atomic price calculation, inventory locking, automatic tax computation (GST / HSN rates), and returns instant checkout tokens or deep-link UPI URLs.

Request Payload & Code Examples

curl -X POST https://api.ecomify.io/v1/orders \
  -H "Authorization: Bearer sec_live_98a76f23b" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": {
      "name": "Priya Sharma",
      "email": "priya@example.com",
      "phone": "+919876543210"
    },
    "items": [
      { "sku": "SNK-001-BLK", "quantity": 1, "price": 2499 }
    ],
    "currency": "INR",
    "payment_method": "upi_intent"
  }'

Request Body Parameters

Field	Type	Description
customerobjectrequired	Object	Contains customer `name`, `email`, and 10-digit Indian `phone` number.
itemsarrayrequired	Array<Item>	List of order line items with `sku`, `quantity`, and unit `price` in INR.
currencystringrequired	String	Three-letter ISO currency code. Defaults to `INR`.
payment_methodstring	String	`upi_intent`, `upi_qr`, `card`, `netbanking`, or `cod`.

Response Object (201 Created)

{
  "status": "success",
  "data": {
    "id": "ord_91823x9A",
    "amount": 2499,
    "currency": "INR",
    "status": "pending_payment",
    "payment_url": "upi://pay?pa=ecomify@icici&pn=Ecomify&am=2499&tr=ord_91823x9A",
    "customer": {
      "id": "cus_9F3xk2",
      "name": "Priya Sharma",
      "phone": "+919876543210"
    },
    "created_at": "2026-09-28T10:15:00Z"
  }
}