FitUP Open API FitUP Open API

Issue an access token for your client. The returned JWT carries your client id, tenant and granted scopes. ออก access token ให้ client ของคุณ — JWT ที่ได้จะบรรจุ client id, tenant และ scope ที่ได้รับไว้ภายใน

Requestคำขอ

curl -X POST "$BASE/api/oauth/token" \
  -H 'Content-Type: application/json' \
  -d '{"clientId":"YOUR_CLIENT_ID","clientSecret":"YOUR_CLIENT_SECRET"}'

Responseการตอบกลับ · 200

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400
}

Tells you what the token you just sent is: the client id it was issued to, the tenant it is bound to, the scopes it grants, and when it expires. Readable with any valid token (it only ever describes your own token) — use it to confirm your grants before investigating a 403 { "error": "Insufficient scopes" }, or to decide when to request a fresh token. บอกว่า token ที่คุณเพิ่งส่งมาเป็นของอะไร: client id ที่ออก token นี้, tenant ที่ผูกไว้, scope ที่ได้รับ และเวลาหมดอายุ · อ่านได้ด้วย token ที่ใช้ได้ทุกตัว (แสดงเฉพาะข้อมูลของ token ตัวคุณเอง) — ใช้ตรวจสิทธิ์ที่ได้รับก่อนไล่หาสาเหตุของ 403 { "error": "Insufficient scopes" } หรือใช้ดูว่าควรขอ token ใหม่เมื่อไร

curl "$BASE/api/me" -H "Authorization: Bearer $TOKEN"

Responseการตอบกลับ · 200

{
  "clientId": "acme-pos",
  "tenantId": "tenant-123",
  "scopes": ["read:members", "read:products", "write:purchases"],
  "vatRate": 0.07,
  "isVatRegistered": true,
  "expiresAt": "2026-07-29T10:00:00Z"
}

List the tenant's members, newest first, paginated. query is a free-text search over name, nickname, phone and member code. แสดงรายการสมาชิกของ tenant แบบแบ่งหน้า — query เป็นการค้นหาข้อความอิสระ จากชื่อ, ชื่อเล่น, เบอร์โทร และรหัสสมาชิก

curl "$BASE/api/members?page=1&pageSize=10&query=somchai" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'branch-id: 2'

{
  "pagination": { "total": 100, "page": 1, "pageSize": 10 },
  "data": [
    {
      "id": 123,
      "firstName": "Somchai",
      "lastName": "Jaidee",
      "nickName": "Chai",
      "phone": "+66812345678",
      "dateOfBirth": "1990-05-21T00:00:00.000Z",
      "memberCode": "M0001",
      "creditBalance": 500,
      "imageUrl": "https://cdn.example.com/avatars/123.jpg"
    }
  ]
}

List the tenant's catalog, paginated. Send the branch-id header to scope to one branch (that branch's products plus the ones sold at every branch) and to receive each item's on-hand stock inline. แสดงแคตตาล็อกสินค้าของ tenant แบบแบ่งหน้า — ใส่ header branch-id เพื่อจำกัดเฉพาะสาขานั้น (สินค้าของสาขานั้น บวกสินค้าที่ขายทุกสาขา) และจะได้สต็อกคงเหลือของแต่ละรายการ แนบมาด้วย

curl "$BASE/api/products?page=1&pageSize=10&paymentType=CASH&categoryId=3" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'branch-id: 2'

{
  "pagination": { "total": 42, "page": 1, "pageSize": 10 },
  "data": [
    {
      "id": "8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81",
      "title": "Protein Shake",
      "description": "Chocolate",
      "skuCode": "PS-001",
      "paymentType": "CASH",
      "price": 89.90,
      "unit": "bottle",
      "isActive": true,
      "trackStock": true,
      "branchIds": [],
      "branchId": null,
      "imageUrl": "https://cdn.example.com/products/ps-001.jpg",
      "categoryId": 3,
      "createdAt": "2026-01-10T08:00:00.000Z",
      "updatedAt": "2026-02-01T09:30:00.000Z",
      "stock": { "branchId": 2, "quantity": 24, "reorderLevel": 6, "lowStock": false }
    }
  ]
}

The tenant's product categories (flat, one level). Pass an id as ?categoryId= on GET /api/products. Query active=true for active categories only. หมวดสินค้าของ tenant (ชั้นเดียว ไม่มีหมวดย่อย) — นำ id ไปใส่เป็น ?categoryId= ใน GET /api/products · ใส่ active=true เพื่อเอาเฉพาะหมวดที่เปิดใช้งาน

curl "$BASE/api/product-categories?active=true" \
  -H "Authorization: Bearer $TOKEN"

[
  {
    "id": 3,
    "nameTh": "อาหารเสริม",
    "nameEn": "Supplements",
    "name": "อาหารเสริม",
    "sortOrder": 0,
    "isActive": true,
    "isDefault": false
  },
  {
    "id": 7,
    "nameTh": "อื่นๆ",
    "nameEn": "Other",
    "name": "อื่นๆ",
    "sortOrder": 9999,
    "isActive": true,
    "isDefault": true
  }
]

The tenant's active branches — reference data, readable with any valid token (you only ever see your own tenant's branches). Use an id from here as the branch-id header elsewhere. สาขาที่เปิดใช้งานของ tenant — เป็นข้อมูลอ้างอิงที่อ่านได้ด้วย token ที่ใช้ได้ทุกตัว (คุณเห็นเฉพาะสาขาของ tenant ตัวเอง) · นำ id จากที่นี่ไปใส่เป็น header branch-id ในการเรียกอื่น ๆ

curl "$BASE/api/branches" -H "Authorization: Bearer $TOKEN"

[
  { "id": 1, "code": "HQ",    "name": "Headquarters" },
  { "id": 2, "code": "BR-02", "name": "Sukhumvit" }
]

Check that a POS machine serial is registered to a branch before you start sending it as posId on sales. Send the serial printed on the machine with the branch-id header of the branch it stands in (required) and you get the machine back; send one that is not registered to that branch and you get 400 POS_NOT_FOUND. Readable with any valid token — it only confirms a machine that is already yours, so no extra scope. ใช้ตรวจว่าหมายเลขเครื่อง (serial) ของเครื่อง POS ลงทะเบียนไว้กับสาขานั้นจริง ก่อนเริ่มส่งเป็น posId ในการขาย · ส่ง serial ที่พิมพ์อยู่บนตัวเครื่อง พร้อม header branch-id ของสาขาที่เครื่องตั้งอยู่ (บังคับ) ระบบจะคืนข้อมูล เครื่องกลับมา · หากส่งค่าที่ไม่ได้ลงทะเบียนกับสาขานั้น จะได้ 400 POS_NOT_FOUND · เรียกได้ด้วย token ที่ใช้ได้ทุกตัว เพราะเป็นเพียงการยืนยันเครื่องที่เป็นของคุณอยู่แล้ว จึงไม่ต้องมี scope เพิ่ม

curl -X POST "$BASE/api/branch-pos/activate" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'branch-id: 2' \
  -d '{ "posId": "E030230003A0050" }'

{
  "id": "7c1f0a94-3b52-4de6-9f18-6c0b2d8ae431",
  "posId": "E030230003A0050",
  "posNumber": "NP01",
  "branchId": 2
}

Record a complete sale in one call: validates the products, deducts stock for trackStock products, deducts the member's credit wallet on CREDIT payments, writes the receipt and returns the totals. The branch-id header is required. บันทึกการขายให้ครบในคำขอเดียว: ตรวจสอบสินค้า, ตัดสต็อกสำหรับสินค้าที่ trackStock, ตัดเครดิตของสมาชิกเมื่อชำระแบบ CREDIT, บันทึกใบเสร็จ และคืนยอดรวมกลับมา · header branch-id บังคับ

curl -X POST "$BASE/api/purchases" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'branch-id: 2' \
  -d '{
    "items": [
      { "productId": "8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81", "qty": 2 },
      { "productId": "b1c2d3e4-7a88-4d0a-9c31-55e0a7f2c410", "qty": 1, "lineDiscount": 25.00 }
    ],
    "cashierId": 456,
    "paymentType": "CASH",
    "receiptPaymentMethod": "CASH",
    "paid": 250.00
  }'

{
  "success": true,
  "purchaseId": "3d9f8a5c-1e2b-47d6-8c90-af7b21d4e6c3",
  "receiptId": 1024,
  "receiptCode": "RCPT-2026-001024",
  "currency": "THB",
  "subtotal": 250.00,
  "discount": 25.00,
  "vat": 14.72,
  "vatRate": 0.07,
  "total": 225.00,
  "paid": 250.00,
  "change": 25.00,
  "receipt": {
    "fitness": { "name": "Fitup Fitness Co., Ltd.", "taxId": "0105561234567", "logoUrl": "https://.../logo.png" },
    "branch": {
      "name": "สาขาสยาม", "code": "BKK-01", "addressLine": "999 ถนนพระราม 1", "zipCode": "10330",
      "officePhone": "021234567", "subDistrict": "ปทุมวัน", "district": "ปทุมวัน", "province": "กรุงเทพมหานคร",
      "isHeadOffice": false, "label": "สาขา สาขาสยาม (BKK-01)"
    },
    "receipt": {
      "code": "RCPT-2026-001024", "issuedAt": "2026-08-04 10:30", "vatPercent": 7,
      "beforeVat": "210.28", "vat": "14.72", "total": "225.00",
      "totalInThai": "สองร้อยยี่สิบห้าบาทถ้วน"
    },
    "items": [
      { "no": 1, "name": "Protein Shake", "qty": "2.00", "unitPrice": "89.90", "lineDiscount": "0.00", "lineTotal": "179.80" },
      { "no": 2, "name": "Shaker Bottle", "qty": "1.00", "unitPrice": "70.20", "lineDiscount": "25.00", "lineTotal": "45.20" }
    ],
    "member": { "firstName": "สมชาย", "lastName": "ใจดี" },
    "cashier": { "firstName": "Staff", "lastName": "One" }
  }
}

On-hand stock across products, paginated. Query: branchId, lowStock (true = at or below the reorder level), page, pageSize. ยอดคงเหลือของสินค้าทั้งหมดแบบแบ่งหน้า · พารามิเตอร์: branchId, lowStock (true = ถึงหรือต่ำกว่าจุดสั่งซื้อ), page, pageSize

curl "$BASE/api/stock?branchId=2&lowStock=true&page=1&pageSize=20" \
  -H "Authorization: Bearer $TOKEN"

{
  "pagination": { "total": 12, "page": 1, "pageSize": 20 },
  "data": [
    {
      "productId": "8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81",
      "branchId": 2,
      "quantity": 4,
      "reorderLevel": 6,
      "lowStock": true,
      "updatedAt": "2026-07-20T04:10:00.000Z"
    }
  ]
}

On-hand for one product across every branch. {id} is the product id. Returns an array of the same stock rows as above. ยอดคงเหลือของสินค้าหนึ่งรายการในทุกสาขา — {id} คือรหัสสินค้า ผลลัพธ์เป็น array ของแถวสต็อกรูปแบบเดียวกับด้านบน

curl "$BASE/api/products/8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81/stock" \
  -H "Authorization: Bearer $TOKEN"

What one product holds at one branch and what it is worth: stockValue is the batches still on hand valued at what each actually cost (FIFO), not quantity × today's price. branchId is required — stock, and so its value, only means anything per branch. ยอดคงเหลือและมูลค่าของสินค้าหนึ่งรายการที่สาขาหนึ่ง — stockValue คิดจากล็อตที่เหลืออยู่ตามต้นทุนจริงของแต่ละล็อต (FIFO) ไม่ใช่จำนวน × ราคาขายวันนี้ · ต้องระบุ branchId เพราะสต็อกและมูลค่ามีความหมายแยกตามสาขาเท่านั้น

curl "$BASE/api/products/8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81/stock/summary?branchId=2" \
  -H "Authorization: Bearer $TOKEN"

{
  "productId": "8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81",
  "branchId": 2,
  "quantity": 15,
  "quantityCosted": 15,
  "stockValue": 2775,
  "avgCost": 185,
  "avgSalePrice": 249
}

Open lots in consume order (FEFO → FIFO), paginated. Query: productId, branchId, page, pageSize. ล็อตที่ยังมีของเหลือ เรียงตามลำดับที่จะถูกตัด (FEFO → FIFO) แบบแบ่งหน้า · พารามิเตอร์: productId, branchId, page, pageSize

curl "$BASE/api/stock/lots?productId=8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81&branchId=2" \
  -H "Authorization: Bearer $TOKEN"

{
  "pagination": { "total": 3, "page": 1, "pageSize": 10 },
  "data": [
    {
      "id": "0f21a7c4-52d8-4a1e-b6d3-9c8f10a4e772",
      "productId": "8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81",
      "branchId": 2,
      "lotNo": "LOT-2026-07",
      "qtyReceived": 24,
      "qtyRemaining": 4,
      "receivedAt": "2026-07-01T02:00:00.000Z",
      "expiryDate": "2026-09-30",
      "refNo": "PO-8891",
      "note": ""
    }
  ]
}

Open lots expiring within N days, soonest first — already-expired lots are included with a negative daysUntilExpiry. Query: days (default 30), branchId. ล็อตที่จะหมดอายุภายใน N วัน เรียงจากใกล้หมดอายุที่สุด — รวมล็อตที่หมดอายุแล้ว โดย daysUntilExpiry จะเป็นค่าติดลบ · พารามิเตอร์: days (ค่าเริ่มต้น 30), branchId

curl "$BASE/api/stock/expiring?days=30&branchId=2" \
  -H "Authorization: Bearer $TOKEN"

[
  {
    "id": "0f21a7c4-52d8-4a1e-b6d3-9c8f10a4e772",
    "productId": "8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81",
    "branchId": 2,
    "lotNo": "LOT-2026-07",
    "qtyRemaining": 4,
    "expiryDate": "2026-08-05",
    "daysUntilExpiry": 8,
    "expired": false
  }
]

Deduct stock for an order's line items — atomic across items and idempotent by orderNo. If any tracked item lacks stock the whole call fails with 409 and nothing is deducted; the message names the product (insufficient stock for product <productId>). A replay of an applied orderNo returns "applied": false. ตัดสต็อกตามรายการของออร์เดอร์ — ทำเป็นหน่วยเดียว (atomic) ทุกบรรทัด และเป็น idempotent ด้วย orderNo · หากมีรายการที่นับสต็อกใดสต็อกไม่พอ ทั้งคำขอจะล้มเหลวด้วย 409 และไม่มีการตัดสต็อกเลย โดยข้อความจะระบุสินค้าที่ไม่พอ (insufficient stock for product <productId>) · การเรียกซ้ำด้วย orderNo ที่ตัดไปแล้วจะได้ "applied": false

Only meaningful for products with "trackStock": true. A catalog-only product ("trackStock": false) has no on-hand by design and is always sellable, so its line moves no stock and is listed in untracked on the response instead of failing the order — you never need to know which products the tenant tracks before selling them. ใช้ได้จริงกับสินค้าที่ "trackStock": true เท่านั้น · สินค้าที่ไม่นับสต็อก ("trackStock": false) ไม่มียอดคงเหลือโดยการออกแบบและขายได้เสมอ ดังนั้นบรรทัดนั้น จะไม่ตัดสต็อกและจะถูกแจ้งกลับใน untracked แทนที่จะทำให้ออร์เดอร์ล้มเหลว — คุณไม่จำเป็นต้องรู้ล่วงหน้าว่าสินค้าใดของร้านนับสต็อกอยู่

curl -X POST "$BASE/api/stock/sale" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'X-Correlation-Id: my-trace-0001' \
  -d '{
    "orderNo": "SO-1001",
    "branchId": 2,
    "contact": "Somchai P.",
    "actor": "Cashier 01",
    "items": [ { "productId": "8f3a1c2e-6b4d-4c19-9f77-2a1e5c0d3b81", "qty": 2, "unitPrice": 199 } ]
  }'

{
  "success": true,
  "applied": true,
  "orderNo": "SO-1001",
  "untracked": ["4c8b0d71-2f19-4a53-8e6c-9b7d1a2f3e40"]
}

Compensate a prior stock sale — e.g. your order failed after the deduction. The exact lots are restored; idempotent, so a second reverse returns "reversed": false. No body needed. คืนสต็อกที่ตัดไปก่อนหน้า เช่น ออร์เดอร์ของคุณล้มเหลวหลังตัดสต็อกไปแล้ว — ระบบคืนเข้าล็อตเดิมทุกล็อต และเป็น idempotent ดังนั้นเรียกซ้ำจะได้ "reversed": false · ไม่ต้องส่ง body

curl -X POST "$BASE/api/stock/sale/SO-1001/reverse" \
  -H "Authorization: Bearer $TOKEN"

{ "success": true, "reversed": true, "orderNo": "SO-1001" }

The interested-service options to offer on your form. Use each slug in the lead's interestedService array; show the label. ตัวเลือก "บริการที่สนใจ" สำหรับใส่ในฟอร์มของคุณ — ใช้ค่า slug ในอาร์เรย์ interestedService ของ lead และแสดงข้อความจาก label

curl "$BASE/api/interest-service" -H "Authorization: Bearer $TOKEN"

[
  { "slug": "personal-training", "label": "Personal Training" },
  { "slug": "yoga",              "label": "Yoga" }
]

Capture an incomplete lead, e.g. from a website or campaign form. Optional branch-id header (default 1) attaches the lead to a branch. All five body fields are required. บันทึกลูกค้ามุ่งหวังที่ยังไม่สมัคร เช่น จากฟอร์มบนเว็บไซต์หรือแคมเปญ · header branch-id (ไม่บังคับ ค่าเริ่มต้น 1) ใช้ผูก lead กับสาขา · ฟิลด์ทั้งห้าใน body บังคับทั้งหมด

curl -X POST "$BASE/api/leads" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'branch-id: 1' \
  -d '{
    "firstName": "Nok",
    "lastName": "Suksawat",
    "phone": "0812345678",
    "email": "nok@example.com",
    "interestedService": ["personal-training", "yoga"]
  }'

{ "success": true }

Deduct credit from a member identified by userId. credit must be ≥ 0. description is optional and lands on the wallet ledger entry. ตัดเครดิตจากสมาชิกที่ระบุด้วย userId · credit ต้องมีค่า ≥ 0 · description ไม่บังคับ และจะถูกบันทึกลงรายการเดินบัญชีของกระเป๋าเงิน

curl -X POST "$BASE/api/pay-with-credit" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"userId":123,"credit":150,"receiptNo":"RCPT-1001","description":"POS sale"}'

{ "success": true }

Deduct credit from the member identified by a scanned QR payload. The QR is single-use — its nonce is consumed on first redemption, so the same QR cannot be charged twice — and the deduction is additionally idempotent by receiptNo. ตัดเครดิตจากสมาชิกที่ระบุด้วย payload จากการสแกน QR · QR ใช้ได้ครั้งเดียว (nonce ถูกใช้ไปเมื่อแลกครั้งแรก จึงไม่สามารถตัดเงินด้วย QR เดิมซ้ำได้) และการตัดยังเป็น idempotent ด้วย receiptNo อีกชั้นหนึ่ง

curl -X POST "$BASE/api/pay-with-qr" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"payload":"<scanned-qr-string>","credit":150,"receiptNo":"RCPT-1002","description":"POS sale"}'

{ "success": true }

Create a one-time Payment Gateway transaction and redirect the customer to the returned paymentUrl. Required: branchId, orderNo, amount. สร้างรายการชำระเงินแบบครั้งเดียว แล้วพาลูกค้าไปที่ paymentUrl ที่ได้กลับมา · ฟิลด์บังคับ: branchId, orderNo, amount

curl -X POST "$BASE/api/payments" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "branchId": 1,
    "orderNo": "ORD-1001",
    "customerId": "CUST-9",
    "amount": 89.92,
    "currency": "THB",
    "channel": "qr_promptpay",
    "customerEmail": "cust@example.com",
    "langCode": "TH"
  }'

{
  "orderNo": "ORD-1001",
  "transactionId": 550231,
  "channelCode": "bank_qrcode",
  "paymentUrl": "https://sandbox-cashier.chillpay.co/...",
  "expiredDate": "2026-07-28T10:15:00.000Z"
}

Poll a payment's status with the transactionId from the create call. Returns the transaction as recorded by the payment service; 404 when the id is unknown to your tenant. ตรวจสถานะการชำระเงินด้วย transactionId ที่ได้จากตอนสร้างรายการ · ผลลัพธ์คือรายการตามที่บริการชำระเงินบันทึกไว้ และจะได้ 404 หากไม่พบ id นั้นใน tenant ของคุณ

curl "$BASE/api/payments/550231/status" -H "Authorization: Bearer $TOKEN"

Responseการตอบกลับ · 200

{
  "transactionId": 550231,
  "orderNo": "ORD-1001",
  "paymentStatus": 0,
  "statusText": "Complete",
  "bankCode": "SCB",
  "bankRefCode": "0043215",
  "amount": 250.00,
  "currency": 764
}

Status codesรหัสสถานะ

Create a hosted payment link (and QR image) you can send to a customer. Required: orderNo, productName, amount. Optional: branchId, productDescription (defaults to productName), startDate (default now), expiredDate (default +24h), paymentLimit (default 1; 0 = unlimited). สร้างลิงก์ชำระเงิน (พร้อมภาพ QR) เพื่อส่งให้ลูกค้า · ฟิลด์บังคับ: orderNo, productName, amount · ไม่บังคับ: branchId, productDescription (ค่าเริ่มต้นเท่ากับ productName), startDate (ค่าเริ่มต้น = ตอนนี้), expiredDate (ค่าเริ่มต้น +24 ชม.), paymentLimit (ค่าเริ่มต้น 1; ใส่ 0 = ไม่จำกัดจำนวนครั้ง)

curl -X POST "$BASE/api/paylink" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "branchId": 1,
    "orderNo": "PL-2001",
    "productName": "Monthly membership",
    "amount": 1290.00,
    "currency": "THB",
    "expiredDate": "2026-08-01T17:00:00Z",
    "paymentLimit": 1
  }'

{
  "orderNo": "PL-2001",
  "payLinkId": 88134,
  "paymentUrl": "https://sandbox-paylink.chillpay.co/...",
  "qrImage": "https://sandbox-paylink.chillpay.co/qr/...",
  "status": "ACTIVE"
}

Fetch one PayLink transaction — whether it was paid, when, and for how much. ดึงข้อมูลรายการของ PayLink หนึ่งรายการ — ชำระแล้วหรือไม่ ชำระเมื่อไร และเป็นจำนวนเท่าไร

curl "$BASE/api/paylink/transactions/88134" -H "Authorization: Bearer $TOKEN"

Create a subscription schedule. Required: orderNo, amount (per cycle), billingDueDate, billingCycle (day | month | year) and billingRound (the interval multiplier, e.g. 1). Omit totalBilling for an open-ended subscription. Send the customer to verifyPaymentUrl once to register their card. สร้างรอบตัดเงินอัตโนมัติ (subscription) · ฟิลด์บังคับ: orderNo, amount (ต่อรอบ), billingDueDate, billingCycle (day | month | year) และ billingRound (ตัวคูณช่วงเวลา เช่น 1) · ไม่ใส่ totalBilling = ตัดเรื่อยไปไม่จำกัดรอบ · พาลูกค้าไปที่ verifyPaymentUrl หนึ่งครั้งเพื่อผูกบัตร

curl -X POST "$BASE/api/recurring/schedules" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "branchId": 1,
    "customerId": "CUST-9",
    "customerEmail": "cust@example.com",
    "orderNo": "SUB-3001",
    "amount": 1290.00,
    "currency": "THB",
    "description": "Gold membership",
    "billingDueDate": "2026-08-01",
    "billingCycle": "month",
    "billingRound": 1,
    "totalBilling": 12
  }'

{
  "recurringScheduleId": "b7c1f0d2-4a55-4e9b-9c31-0a8d7e6f5b42",
  "verifyPaymentUrl": "https://sandbox-cashier.chillpay.co/verify/...",
  "status": "PENDING_VERIFY"
}

Fetch a schedule's current state — verification status, next billing date and rounds billed so far. ดึงสถานะปัจจุบันของรอบตัดเงิน — สถานะการยืนยันบัตร, วันตัดรอบถัดไป และจำนวนรอบที่ตัดไปแล้ว

curl "$BASE/api/recurring/schedules/b7c1f0d2-4a55-4e9b-9c31-0a8d7e6f5b42" \
  -H "Authorization: Bearer $TOKEN"

Stop future billing for a schedule. The body is optional: { "reason": "..." } is stored with the cancellation. Already-billed rounds are not refunded. หยุดการตัดเงินรอบถัดไปของ schedule นั้น · body ไม่บังคับ — ส่ง { "reason": "..." } เพื่อบันทึกเหตุผลไว้กับการยกเลิก · รอบที่ตัดเงินไปแล้วจะไม่ถูกคืนเงิน

curl -X POST "$BASE/api/recurring/schedules/b7c1f0d2-4a55-4e9b-9c31-0a8d7e6f5b42/cancel" \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"reason":"customer request"}'