Chuchu Merchant API

Merchant API нь мерчантын өөрийн систем — ERP, дэлгүүр, POS, CRM — Chuchu руу хүн нэвтрэхгүйгээр захиалга үүсгэж, унших боломж олгоно.

Энэ нь version 1. HTTP зам /api/v1/merchant/.... Нээлттэй хүсэлт, хариуны хэлбэр бол гэрээ.

Эхлэх

1. Chuchu дээр Тохиргоо → Хөгжүүлэгч / API нээ.
2. API түлхүүр үүсгээд нууцыг даруй хуул. Нэг л удаа харагдана.
3. Нууцыг CHUCHU_API_KEY гэж хадгал. Репозиторид бүү оруул.
4. Захиалга үүсгээд буцааж унш. Дахин илгээхдээ мөн Idempotency-Key явуул.

curl -X POST https://api.chuchu.mn/api/v1/merchant/orders \
  -H "Authorization: Bearer $CHUCHU_API_KEY" \
  -H "Idempotency-Key: SHOP-10492" \
  -H "Content-Type: application/json" \
  -d '{
    "externalOrderId": "SHOP-10492",
    "customer": {
      "externalCustomerId": "CUS-991",
      "name": "Bat",
      "phone": "99112233",
      "email": null,
      "address": {
        "label": "Delivery",
        "contactName": "Bat",
        "contactPhone": "99112233",
        "district": "Bayanzurkh",
        "khoroo": "26",
        "addressLine": "Full human-readable address",
        "latitude": "47.918",
        "longitude": "106.944",
        "deliveryInstructions": "Call before arriving"
      }
    },
    "requestedDeliveryDate": "2026-09-07",
    "collectionMode": "COLLECT",
    "collectionAmount": "55000",
    "currency": "MNT",
    "notes": "External order",
    "items": [
      {
        "externalItemId": "LINE-1",
        "sku": "PAPER-A4",
        "name": "A4 Paper",
        "quantity": "2",
        "unit": "box",
        "unitPrice": "27500",
        "discount": "0"
      }
    ]
  }'

OpenAPI: https://api.chuchu.mn/docs/merchant

Заавар

• Нэвтрэлт
• Захиалга
• Бүтээгдэхүүн
• Idempotency
• Алдаа
• Хязгаар

Хувилбар

Нээлттэй DTO, зам, нэвтрэлтийн эвдэх өөрчлөлт шинэ хувилбар шаардана (/api/v2/merchant/...). Хариунд нэмэлт сонголттой талбар нэмэх нь эвдэх өөрчлөлт биш.

X-Merchant-Id илгээхгүй. API түлхүүр мерчантыг сонгоно.