WINGO.GE Logo

Integration for stores and platforms

Our API lets your store or platform send orders automatically into our logistics system – the same way large partners like bookstores or e‑commerce platforms integrate.

1. Connect

We issue your API Key / Bearer token and a test environment. Optionally we can restrict by IP.

2. Send Order + Tracking

Your system sends orders via the Send Order API, and we return statuses and tracking via Check Order endpoints.

3. Callback & safety

On successful order creation we can call back your URL. End‑customers only see the data they should see.

Step‑by‑step integration
  1. We align fields: how your order number is named (`order_id`, `partners_order_id`, `business_order_id`) and which fields you need (Same Day / Next Day, COD, etc.).
  2. We send you an API Key or Bearer token and the `BASE_URL` (e.g. `https://your-domain/api/v1`).
  3. Your developer connects to the `POST /orders` endpoint using the Send Order JSON example (below).
  4. You add a tracking link that uses `GET /orders/track?order_number=...`.
  5. Optionally we enable callbacks (webhooks) when an order is created or its status changes.

Send Order – what you send

For each order you send a JSON object. The key parts are: your unique order number, recipient (name, phone, address), region and delivery type.

  • Auth: Authorization: Bearer <YOUR_ACCESS_TOKEN> or X-API-Key: <YOUR_API_KEY>
  • URL: POST {BASE_URL} /orders
  • Content-Type: application/json
Request example
POST /api/v1/orders
{
  "userId": "merchant-user-id",
  "orderNumber": "BIBLUS-2025-001234",
  "recipientName": "გიორგი გიორგაძე",
  "recipientPhone": "+995555123456",
  "regionId": "<region-id-from-GET-regions>",
  "deliveryAddress": "მომხმარებლის მისამართი, თბილისი",
  "pickupAddress": "ბიბლუსის საწყობი, ვაჟა-ფშაველას 1",
  "deliveryTypeId": 1,
  "timeSlotId": "<time-slot-id-from-GET-time-slots>",
  "weightRangeId": 1,
  "recipientPaymentDue": 25.50,
  "deliveryDate": "2025-01-28",
  "sellerComment": "ბიბლუსიდან",
  "courierComment": "მეორე სართულზე",
  "products": [
    { "productName": "წიგნის სახელი", "quantity": 2 }
  ],
  "callback_url": "https://partner.com/api/runner-callback"
}

Check Order / Tracking (business view)

Your backend can check order status at any time: picked up, on the way, delivered, etc.

  • URL: GET {BASE_URL} /orders/track?order_number=<orderNumber>
  • You see: internal statuses, history and technical IDs – for your back‑office only.

What your customer sees

On the public tracking page we do not expose pickup address or your internal data – only safe information:

  • Company name (e.g. ISARI.store)
  • Contact phone (e.g. (032) 2 11 24 25)
  • Default address (e.g. Tbilisi, France str. 4)
  • Current status: picked up, on the way, delivered, etc.

Reference APIs (Regions, Delivery Types…)

Use these endpoints to populate your forms with regions, delivery types, time slots and weight ranges.

Regions
GET {BASE_URL} /regions

List of regions (`regionId`).

Delivery Types
GET {BASE_URL} /delivery-types

Same Day / Next Day (`deliveryTypeId`).

Order Statuses
GET {BASE_URL} /order-statuses

Status list for tracking.

Time Slots
GET {BASE_URL} /time-slots

Delivery time slots.

Weight Ranges
GET {BASE_URL} /car-types/weight-ranges

Weight ranges (`weightRangeId`).