May online store ka na? I-connect ito sa iLoope.

Ang buong proseso, sa isang tingin

Step 1 — Mag-apply bilang Ecom Merchant

Pumunta sa iloope.com/apply/ecom-merchant (kailangan ng iLoope account, libre mag-sign up). Ihanda ang:

• Business permit (DTI / SEC / Mayor's) — required
• BIR registration / TIN — required
• Valid ID + selfie — kung hindi pa verified ang iLoope account KYC mo
• URL ng online store mo — dapat live, bibisitahin ng reviewer
• Platform ng store (WooCommerce / Shopify / Laravel / custom)

Pagkatapos mag-submit, makakatanggap ka ng application code (APP-XXXXXX) para ma-track ang status sa /apply/status.

Step 2 — Ano ang mangyayari pag-approve

• Magkakaroon ka ng seller store sa iLoope (dito nakalagay ang products mo).
• Bubukas ang Merchant Portal mo sa iloope.com/merchant/integration.
• Bubukas din ang Partner Portal (/partner/padala) para sa delivery settings, history, at COD remittance.

Step 3 — Kunin ang API key

Sa Merchant Portal, pindutin ang Generate API key. Ipapakita ito nang isang beses lang — kopyahin agad at itago sa server config mo (huwag i-commit sa code). Gamitin ito sa bawat API request:

curl https://iloope.com/api/merchant/ping \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Kung na-compromise ang key: Rotate sa portal — mamamatay agad ang luma.

Step 4 — Piliin ang connection mode

	📤 Push mode (recommended)	📥 Pull mode
Sino ang tumatawag	Ang site MO ang tumatawag sa iLoope API	Si iLoope ang tumatawag sa API ng site mo
Kailangan mong gawin	Mag-HTTP request lang (kahit anong platform)	I-implement ang 3 endpoints sa site mo
Bagay para sa	Karamihan ng merchants	Merchants na may dev team at gustong si iLoope ang kumuha

Push mode — ipadala ang products mo

curl -X POST https://iloope.com/api/merchant/products \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "full_sync": true,
    "products": [
      {
        "id": 101,
        "name": "Super BarliCao",
        "description": "Barley + cacao health drink",
        "price": 350.00,
        "stock": 25,
        "in_stock": true,
        "category": "Health Drinks",
        "image": "https://www.mystore.com/img/101.png",
        "images": ["https://www.mystore.com/img/101.png"]
      }
    ]
  }'

• id = ang product id sa SISTEMA MO — dapat stable; ito ang susi ng updates.
• full_sync: true = buong catalog ang pinadala mo; ang wala sa listahan ay itatago sa iLoope. Gamitin ang false para sa partial updates.
• Max 500 products bawat tawag; tumawag nang paulit-ulit para sa mas malaki.
• ⏳ Product review: ang bawat BAGONG product ay irereview muna ng iLoope bago lumabas sa marketplace (kadalasan sa loob ng 1 business day) — hindi lahat ng puwede sa site mo ay puwede sa iLoope. Ang response ay may held_for_review count. Ang updates sa approved products (presyo/stock) ay agad na tumatalab.

Pull mode — i-implement ang endpoints na ito sa site mo

Gumawa ng API key sa side mo, i-paste sa portal kasama ang site URL, at si iLoope ang tatawag (header X-API-Key):

Endpoint (sa site MO)	Sagot
GET /api/iloope/products	{"products": [{id, name, description, price, stock, in_stock, category, image, images[]}]}
GET /api/iloope/products/{id}	{"product": {...}}
POST /api/iloope/orders	Tumanggap ng order: {items:[{product_id, quantity}], customer:{...}, notes, external_ref} → ibalik ang order number mo

May Test connection button sa portal — kapag pumasa, live agad ang products mo.

Step 5 — Tanggapin ang orders

Option A — Webhook (real-time, recommended)

Maglagay ng webhook URL sa portal. Bawat bagong order (bayad na o COD) ay ipu-push namin:

POST https://www.mystore.com/iloope/webhook
X-iLoope-Event: order.created
X-iLoope-Signature: hmac_sha256(raw_body, YOUR_SIGNING_SECRET)

{"event": "order.created", "order": {"order_number": "ORD-...", "items": [...], "customer": {...}}}

I-verify ang signature (makikita ang signing secret sa portal):

// PHP
$raw = file_get_contents('php://input');
$expected = hash_hmac('sha256', $raw, $yourSigningSecret);
if (!hash_equals($expected, $_SERVER['HTTP_X_ILOOPE_SIGNATURE'] ?? '')) {
    http_response_code(401); exit;
}
$payload = json_decode($raw, true);

Sumagot ng 2xx. Kapag pumalya, susubukan ulit — at laging available ang polling bilang fallback.

Option B — Polling

curl "https://iloope.com/api/merchant/orders?since=2026-07-10T00:00:00" \
  -H "Authorization: Bearer YOUR_API_KEY"

payment_status: "paid" = bayad na kay iLoope (online payment). "pending" + payment_method: "cod" = kokolektahin ng rider sa customer.

I-report ang fulfilment progress

curl -X POST https://iloope.com/api/merchant/orders/ORD-XXXX/status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "ready_to_ship"}'

Statuses (forward-only): processing → ready_to_ship → shipped → delivered.

Step 6 — Delivery via iLoope Padala 🛵

Konektado ang store mo sa iLoope Padala — ang courier system ng iLoope. Ang riders namin ang susundo sa address mo, maghahatid sa customer, at kokolekta ng COD para sa iyo.

One-time setup

• Pumunta sa Partner Portal → Delivery settings (/partner/padala/settings).
• I-save ang pickup address (pangalan, phone, address, city) — dito susunduin ng rider ang parcels.
• I-ON ang Auto-dispatch kung gusto mong awtomatikong may rider bawat order na ready.

Para sa iLoope orders — automatic

Kapag minarkahan mong ready_to_ship ang order (nakabalot na), awtomatikong magbo-book ng rider kung naka-ON ang auto-dispatch — o ipasa ang "dispatch_rider": true per order:

curl -X POST https://iloope.com/api/merchant/orders/ORD-XXXX/status \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "ready_to_ship", "dispatch_rider": true}'

// Response kasama ang rider booking:
// {"ok": true, "status": "ready_to_ship",
//  "rider": {"dispatched": true, "reference": "PD-...", "tracking_number": "...",
//            "tracking_url": "https://iloope.com/track/...", "cod_amount": 725.00}}

• Kung COD ang order, ang rider ang kokolekta ng buong halaga sa customer.
• Ang order status ay awtomatikong gagalaw habang naghahatid ang rider: pickup → shipped, delivered → delivered.
• May live tracking link ang bawat shipment — puwede mong ipadala sa customer mo.

Para sa orders sa SARILING website mo — API dispatch

Kahit hindi dumaan sa iLoope ang order, puwede kang magpa-deliver:

curl -X POST https://iloope.com/api/merchant/rider/dispatch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "MYSTORE-ORDER-456",
    "receiver_name": "Juan Dela Cruz",
    "receiver_phone": "09171234567",
    "receiver_address": "123 Rizal St, Kidapawan City",
    "cod_amount": 850.00,
    "package_size": "small",
    "package_description": "2x Super BarliCao"
  }'

Ang sender/pickup ay galing sa saved delivery settings mo (o ipasa ang sender_name/sender_phone/sender_address). I-track: GET /api/merchant/rider/{reference}; kanselahin bago makuha: POST /api/merchant/rider/{reference}/cancel.

COD remittance

Ang COD na nakolekta ng rider ay dumadaan sa iLoope at ibinibigay sa iyo (bawas ang COD service fee). Makikita ang buong remittance report sa Partner Portal → COD remittance (/partner/padala/remittance).

API reference (buod)

Base URL: https://iloope.com/api/merchant · Lahat ng request: Authorization: Bearer YOUR_API_KEY + Accept: application/json

Endpoint	Ano ito
GET /ping	Test ng key + connection status
POST /products	Batch upsert ng products (max 500; full_sync optional)
DELETE /products/{id}	Itago ang isang product
GET /orders	Orders sa iyo (?status=, ?since=)
POST /orders/{order_number}/status	Fulfilment progress; sa ready_to_ship pwedeng mag-auto-dispatch ng rider
POST /rider/dispatch	Mag-book ng iLoope Padala rider para sa own-site order
GET /rider/{reference}	Shipment status + tracking + remittance
POST /rider/{reference}/cancel	Kanselahin bago ma-pickup

FAQ