เลือกแพ็กเกจหรือเติมเครดิต
- แพ็กเกจรายเดือนหรือรายปี
SUBSCRIPTION - ซื้อช่วงเวลาใช้งาน พร้อมโควตาตรวจสลิปรายเดือนและจำนวนสาขา/LINE OA ตามแพ็กเกจที่ชำระแล้ว
- เติมเครดิตเพิ่ม
CREDIT_TOP_UP - เพิ่มเครดิตถาวรแยกจากโควตารายเดือน ไม่ต่ออายุแพ็กเกจและไม่เพิ่มจำนวนสาขาหรือ LINE OA
ราคาในหน้าเว็บไซต์ใช้เปรียบเทียบแผนที่ประกาศเท่านั้น ก่อนชำระให้ตรวจราคาและสิทธิ์ปัจจุบันที่ Merchant Portal ระบบไม่สลับแพ็กเกจหรือเก็บเงินต่ออายุอัตโนมัติ
ดูแพ็กเกจและราคาเติมเครดิต ↗ซื้อและต่ออายุใน Portal
เปิดหน้าเครดิตด้วยบัญชีเจ้าของร้าน
เลือกเมนู เครดิต แพ็กเกจ และใบแจ้งหนี้ ใน Merchant Portal บัญชีพนักงานไม่มีสิทธิ์ออกบิลหรือส่งสลิปชำระค่าบริการ
เลือกแพ็กเกจและรอบชำระ
ดูแพ็กเกจปัจจุบัน วันสิ้นสุด และโควตาที่ใช้แล้ว เลือกซื้อรายเดือน/รายปี หรือเลือกต่ออายุแพ็กเกจเดิมเมื่อระบบอนุญาต
ตรวจยอดและข้อมูลผู้รับบิล
ตรวจราคาที่ระบบคำนวณ โควตา จำนวนสาขา/LINE OA และข้อมูลผู้รับบิลก่อนยืนยัน หากราคาเปลี่ยน ให้โหลดราคาใหม่และตรวจอีกครั้ง
เปิดบิลเดิมแล้วตรวจบัญชีรับเงิน
อ่านเลขอ้างอิง ยอดชำระรวม กำหนดชำระ และคำแนะนำโอนเงินของบิลนั้น ส่งสลิปได้เฉพาะเมื่อระบบเปิดรับชำระ อย่าโอนไปยังบัญชีจากข้อความอื่น
ส่งสลิปและติดตามการจัดสรรสิทธิ์
เลือกช่องทางเดิม BANK_TRANSFER หรือ PROMPTPAY และภาพ JPEG, PNG หรือ WebP ไม่เกิน 10 MiB ตรวจใบเสร็จและวันเริ่ม–สิ้นสุดหลังระบบจัดสรรสำเร็จ เก็บภาพต้นฉบับไว้จนรายการจบ
ปุ่มซื้อแพ็กเกจและส่งสลิปขึ้นกับบริการที่เปิดใช้งานและการยืนยันบัญชีผู้รับ การทดสอบในเครื่องไม่ยืนยันการรับชำระจริง เมื่อระบบแจ้งยังไม่พร้อมให้ติดต่อทีมงานก่อนโอน
รอบใช้งานและโควตารายเดือน
ซื้อใหม่หรือเริ่มหลังหมดอายุ
เมื่อยืนยันใบเสร็จและจัดสรรสำเร็จ ระบบเริ่มรอบใช้งานใหม่และให้โควตาหนึ่งเดือน เครดิตเติมถาวรยังคงอยู่ โควตาแพ็กเกจเก่าที่หมดรอบไม่สะสมเข้าสู่รอบใหม่
ชำระรายปี
ซื้อช่วงเวลาใช้งานหนึ่งปี แต่รับโควตาเป็นรายเดือน ไม่ได้รับเครดิตสิบสองเดือนทันที การรีเซ็ตเดือนถัดไปเป็นไปตามวันครบรอบในเวลาไทย
ต่ออายุก่อนหมดรอบ
รอบที่ซื้อเพิ่มเริ่มจากวันสิ้นสุดเดิม คงเครดิตที่เหลือและโควตาที่ใช้แล้วในเดือนปัจจุบัน ค่า creditsGrantedNow เป็น 0 จึงไม่ใช่ข้อผิดพลาดหรือเครดิตหาย
ต่ออายุด้วยตนเองได้เฉพาะแพ็กเกจเดิมในราคาปัจจุบัน สิทธิ์ที่ชำระแล้วถูกเก็บตามบิลเดิม หากต้องการเปลี่ยนแผนขณะยังมีรอบชำระอยู่ หรือแพ็กเกจเดิมไม่มีวันสิ้นสุด ให้ทีมงานตรวจหลักฐานและรอบใช้งานก่อน
โควตาที่ใช้แล้วนับเฉพาะเครดิตรายเดือนที่หักจากรายการตรวจผ่าน ไม่รวมเครดิตเติมถาวร การตรวจไม่ผ่านไม่ใช้โควตาและคืนเครดิตที่จองไว้ การต่ออายุล่วงหน้าไม่รีเซ็ตการใช้ของเดือนปัจจุบัน
เมื่อแพ็กเกจหมดอายุ โควตารายเดือนหยุดใช้และไม่เพิ่มสาขาหรือ LINE OA ใหม่ รายการที่จองเครดิตก่อนหมดอายุยังทำงานต่อได้ ข้อมูลเดิมยังอ่าน แก้รายละเอียด หรือปิดใช้งานได้ ระบบไม่ลบสาขาหรือประวัติอัตโนมัติ
อ่านสถานะบิลและใบเสร็จ
- 1ออกใบแจ้งหนี้
- 2ยืนยันใบเสร็จ
- 3จัดสรรสิทธิ์แพ็กเกจ
status=PENDING / PROCESSING- บิลยังไม่ดำเนินการสำเร็จ อาจรอเอกสาร รับชำระ หรือจัดสรรสิทธิ์ ต้องอ่านสถานะเอกสารและใบเสร็จประกอบ
invoiceStatus=PAID- CRM แจ้งว่าบิลชำระแล้ว แต่ยังไม่ยืนยันว่า SlipMatrix มีใบเสร็จที่ตรวจครบหรือจัดสรรสิทธิ์สำเร็จ
purpose=SUBSCRIPTION + status=COMPLETED- แพ็กเกจจัดสรรสำเร็จ รายละเอียดต้องมี subscription.appliedAt และ subscription.period พร้อมวันเริ่ม วันสิ้นสุด และ creditsGrantedNow
purpose=CREDIT_TOP_UP + status=COMPLETED- เติมเครดิตสำเร็จ เป็นคนละรายการกับการเปิดใช้หรือต่ออายุแพ็กเกจ
syncStatus=REVIEW_REQUIRED- ต้องให้เจ้าหน้าที่ตรวจยอด ใบเสร็จ และสิทธิ์ก่อนดำเนินการต่อ ห้ามโอนเพิ่มหรือเปิดใช้เอง
status=EXPIRED- บิลท้องถิ่นหมดสภาพตามผลที่ตรวจแล้ว ไม่ใช่หลักฐานว่าเงินถูกคืน กำหนดชำระที่ผ่านไปเพียงอย่างเดียวไม่ได้ยกเลิกบิล
แยกสถานะเอกสาร สถานะตรวจรับชำระ และสถานะบริการ อ่านเลขใบเสร็จ ยอดรับชำระ วันเริ่ม–สิ้นสุด และเครดิตที่จัดสรรทันที อย่าตัดสินจากคำว่า PAID เพียงอย่างเดียว
รายงานรายได้แพลตฟอร์มแยกแพ็กเกจกับเติมเครดิต และนับเฉพาะรายการที่ดำเนินการสำเร็จ ใบเสร็จที่ยังรอจัดสรรหรือกระทบยอดไม่รวมในยอดนี้ โควตาแพ็กเกจไม่ใช่จำนวนเครดิตเติมที่ขาย รายงานนี้ไม่ใช่บัญชีรายได้ตามเกณฑ์คงค้าง
กู้คำขอเดิมและแก้ปัญหา
- กดยืนยันออกบิลแล้วเครือข่ายขาดหาย
- เลือก ดำเนินการคำขอแพ็กเกจเดิมต่อ แม้โหลดหน้าใหม่แล้ว ใช้ข้อมูลและเลขคำขอเดิม ตรวจประวัติก่อนสร้างบิลใหม่ หากข้อมูลกู้คืนอ่านไม่ได้ ให้ตรวจประวัติและติดต่อทีมงานก่อนล้างคำขอ
- CRM_QUOTE_CHANGED
- ราคา สิทธิ์ หรือบริบทแพ็กเกจเปลี่ยนก่อนออกบิล ให้โหลดราคาใหม่และตรวจอีกครั้ง บิลที่ออกสำเร็จแล้วคงยอดและสิทธิ์ของบิลเดิม
- CRM_SUBSCRIPTION_INVOICE_PENDING
- มีบิลแพ็กเกจค้างอยู่ เปิดบิลนั้นและชำระหรือกระทบยอดให้จบก่อนออกบิลใหม่
- CRM_SUBSCRIPTION_BUSY
- มีใบเสร็จแล้วแต่ยังรอรายการตรวจสลิปเดิมที่จองเครดิตไว้ เมื่อรายการเดิมจบให้กด ตรวจสถานะล่าสุด ในบิลเดิม ไม่โอนหรือส่งสลิปใหม่
- CRM_RECEIPT_RECOVERY_REQUIRED หรือผลชำระไม่แน่นอน
- หากยังไม่มีใบเสร็จยืนยัน ให้ตรวจบิลเดิมและใช้ภาพต้นฉบับ ไฟล์และช่องทางชำระเดิมเพื่อกู้ผลเมื่อระบบอนุญาต อย่าบีบอัด แก้ภาพ ถ่ายใหม่ หรือเปลี่ยนช่องทาง เพราะจะไม่ใช่คำขอเดิม
- REVIEW_REQUIRED หรือสิทธิ์ถูกเปลี่ยนระหว่างรอชำระ
- ติดต่อทีมงานพร้อมเลขอ้างอิงบิลและใบเสร็จเพื่อกระทบยอด ไม่เพิ่มเครดิตหรือเปลี่ยนสิทธิ์ด้วยตนเอง และไม่ถือว่าระบบคืนเงินแล้ว
- ต้องการยกเลิกบิลที่ยังไม่ชำระ
- ติดต่อทีมงานเพื่อยกเลิกใน CRM แล้วตรวจสถานะบิลเดิม ต้องยืนยันว่าไม่มีเงินรับหรือผลชำระที่ยังไม่แน่นอนก่อนเปิดบิลใหม่ ไม่มีปุ่มคืนเงินอัตโนมัติใน Portal
คำขอที่หน้า Portal เก็บไว้สำหรับกู้คืนผูกกับบัญชีและแท็บเดิม อย่าล้างข้อมูลเบราว์เซอร์หรือเปลี่ยนเลขคำขอเมื่อยังไม่ทราบผล หากใช้เครื่องหรือแท็บใหม่ ให้ตรวจประวัติบิลของร้านก่อนดำเนินการต่อ
เชื่อมต่อด้วยบัญชีเจ้าของร้าน
เส้นทาง billing ใช้ Authorization: Bearer ของบัญชีเจ้าของร้าน ไม่ใช้ x-app-id หรือ x-api-key และไม่รับ session พนักงาน ใช้เฉพาะการเชื่อมต่อที่ร้านควบคุม ไม่แจก session token ให้ลูกค้าหรือฝังในเว็บไซต์สาธารณะ
API Key และ SDK ตรวจสลิปใช้กับรายการตรวจของร้าน ส่วนการส่งสลิปที่ billing เป็นการชำระค่าบริการ SlipMatrix ไม่ใช่การรับเงินจากลูกค้าหรือปิดออเดอร์ของร้าน
| Method | Path | การใช้งาน |
|---|---|---|
GET | /api/merchant/billing/config | อ่านความพร้อมการออกบิลและรับชำระ |
GET | /api/merchant/billing/subscriptions/catalog | อ่านแพ็กเกจปัจจุบัน รายการราคา สิทธิ์ซื้อ/ต่ออายุ และบิลค้าง |
POST | /api/merchant/billing/subscriptions/quote | คำนวณยอดซื้อหรือต่ออายุ และรับ quoteFingerprint |
POST | /api/merchant/billing/subscriptions/invoices | ออกบิลแพ็กเกจโดยใช้ราคาและเลขคำขอเดิม |
POST | /api/merchant/billing/quote | คำนวณยอดเติมเครดิตจากจำนวนเครดิต |
POST | /api/merchant/billing/invoices | ออกบิลเติมเครดิตด้วย requestKey และ quotedTotal |
GET | /api/merchant/billing/invoices | อ่านประวัติบิลของร้าน ใช้ page และ limit สูงสุด 100 |
GET | /api/merchant/billing/invoices/{id} | อ่านบิล ใบเสร็จ และหลักฐานจัดสรรสิทธิ์ |
POST | /api/merchant/billing/invoices/{id}/retry | กู้การออกเอกสารของบิลเดิม ไม่สร้างคำขอใหม่ |
POST | /api/merchant/billing/invoices/{id}/sync | ตรวจสถานะและจัดสรรจากหลักฐานเดิม ไม่ต้องส่งภาพเมื่อมีใบเสร็จแล้ว |
POST | /api/merchant/billing/invoices/{id}/payments/slip | ส่ง multipart file และ paymentMethod เพื่อชำระบิลเดิม |
ตัวอย่าง body แสดงโครงสร้างเท่านั้น ต้องแทนค่าจาก catalog และ quote ของบัญชีจริง ยอด quotedTotal เป็นข้อความทศนิยมสองตำแหน่ง ส่วน quoteFingerprint ใช้ค่าตอบกลับเดิม ห้ามเดาราคา สร้าง fingerprint เอง หรือสร้าง requestKey ใหม่เมื่อ retry
{
"packageId": "PACKAGE_UUID_FROM_CATALOG",
"action": "PURCHASE",
"billingCycle": "MONTHLY"
}{
"packageId": "SAME_PACKAGE_UUID",
"action": "PURCHASE",
"billingCycle": "MONTHLY",
"requestKey": "ORIGINAL_REQUEST_UUID",
"quotedTotal": "TOTAL_FROM_QUOTE",
"quoteFingerprint": "FINGERPRINT_FROM_QUOTE",
"billing": {
"companyName": "Example store"
}
}เก็บ requestKey และข้อมูลทั้งคำขอก่อนส่ง การส่งซ้ำต้องใช้ packageId, action, billingCycle, quotedTotal, quoteFingerprint และ billing เดิม บิลหนึ่งใบมีเลข id ของระบบเอง ใช้ id นี้อ่านรายละเอียด retry หรือ sync หลังทราบผลแล้ว
ส่งสลิปด้วย multipart/form-data ชื่อ file และ paymentMethod เป็น BANK_TRANSFER หรือ PROMPTPAY ปล่อยให้ HTTP client สร้าง Content-Type พร้อม boundary ใช้ไฟล์ต้นฉบับและช่องทางเดิมเพื่อกู้ผลที่ไม่แน่นอน จำกัดการ retry และรอตาม Retry-After เมื่อได้รับ 429
คู่มือ API สำหรับนักพัฒนา ↗ตรวจสอบก่อนชำระเงิน
- ตรวจชื่อและเลขบัญชีผู้รับจากคำแนะนำในบิลล่าสุด ไม่ใช้บัญชีจากตัวอย่างหรือจากสลิปรายการอื่น
- ยืนยันยอดรวม รอบชำระ และข้อมูลผู้รับบิล ขณะนี้ระบบตั้งค่าไม่คิด VAT ให้ยึดยอดในบิลที่ออกจริง
- หากปุ่มรับชำระหรือ checkout ยังไม่เปิด ให้ติดต่อทีมงานก่อนโอนเงิน ประวัติเดิมยังอ่านได้เมื่อระบบพักรับรายการใหม่
- เก็บเลขอ้างอิงบิลและภาพต้นฉบับ ไม่ส่ง API Key, session token หรือรหัสผ่านให้ลูกค้าหรือใส่ในข้อความขอความช่วยเหลือ