Skip to main content
POST
/
api
/
v1
/
hub
/
shop
/
{shopId}
/
order
Create Manual Order
curl --request POST \
  --url https://api.sabivendor.com/api/v1/hub/shop/{shopId}/order \
  --header 'Content-Type: application/json' \
  --header 'X-Shop-API-Key: <x-shop-api-key>' \
  --data '
{
  "customerName": "<string>",
  "customerPhoneNumber": "<string>",
  "totalPrice": 123,
  "paymentStatus": "<string>",
  "orderStatus": "<string>",
  "orders": [
    {}
  ]
}
'
{
  "status": "success",
  "message": "Order created successfully",
  "data": {
    "id": 502,
    "orderStatus": "delivered",
    "paymentStatus": "paid",
    "reference": "ORD-502-XYZ"
  }
}
Logs an offline order (e.g., walk-in customer, phone order) directly from your backend/pos.

Authorizations

X-Shop-API-Key
string
required
Your Secret API Key (sk_live_... or sk_test_...) generated from the Developer dashboard. Must be kept secret.

Path Parameters

shopId
string
required
The unique UUID of the shop.

Request Body (JSON)

customerName
string
required
Customer name.
customerPhoneNumber
string
required
Customer contact phone number. Must be valid.
totalPrice
number
required
Total price in Kobo.
paymentStatus
string
pending or paid.
orderStatus
string
confirmed, delivered, etc.
orders
array
required
Ordered items list containing productId, variantId, and orderProductQty (min 1).
{
  "status": "success",
  "message": "Order created successfully",
  "data": {
    "id": 502,
    "orderStatus": "delivered",
    "paymentStatus": "paid",
    "reference": "ORD-502-XYZ"
  }
}