Merchant billing · SlipMatrix

คู่มือซื้อแพ็กเกจ ต่ออายุ และชำระค่าบริการ SlipMatrix

วิธีซื้อและต่ออายุแพ็กเกจ เติมเครดิต อ่านใบแจ้งหนี้และใบเสร็จ ติดตามสิทธิ์รายเดือน และกู้คำขอเดิมเมื่อการรับชำระยังไม่แน่นอน

เลือกแพ็กเกจหรือเติมเครดิต

แพ็กเกจรายเดือนหรือรายปี
SUBSCRIPTION
ซื้อช่วงเวลาใช้งาน พร้อมโควตาตรวจสลิปรายเดือนและจำนวนสาขา/LINE OA ตามแพ็กเกจที่ชำระแล้ว
เติมเครดิตเพิ่ม
CREDIT_TOP_UP
เพิ่มเครดิตถาวรแยกจากโควตารายเดือน ไม่ต่ออายุแพ็กเกจและไม่เพิ่มจำนวนสาขาหรือ LINE OA

ราคาในหน้าเว็บไซต์ใช้เปรียบเทียบแผนที่ประกาศเท่านั้น ก่อนชำระให้ตรวจราคาและสิทธิ์ปัจจุบันที่ Merchant Portal ระบบไม่สลับแพ็กเกจหรือเก็บเงินต่ออายุอัตโนมัติ

ดูแพ็กเกจและราคาเติมเครดิต ↗

ซื้อและต่ออายุใน Portal

  1. เปิดหน้าเครดิตด้วยบัญชีเจ้าของร้าน

    เลือกเมนู เครดิต แพ็กเกจ และใบแจ้งหนี้ ใน Merchant Portal บัญชีพนักงานไม่มีสิทธิ์ออกบิลหรือส่งสลิปชำระค่าบริการ

  2. เลือกแพ็กเกจและรอบชำระ

    ดูแพ็กเกจปัจจุบัน วันสิ้นสุด และโควตาที่ใช้แล้ว เลือกซื้อรายเดือน/รายปี หรือเลือกต่ออายุแพ็กเกจเดิมเมื่อระบบอนุญาต

  3. ตรวจยอดและข้อมูลผู้รับบิล

    ตรวจราคาที่ระบบคำนวณ โควตา จำนวนสาขา/LINE OA และข้อมูลผู้รับบิลก่อนยืนยัน หากราคาเปลี่ยน ให้โหลดราคาใหม่และตรวจอีกครั้ง

  4. เปิดบิลเดิมแล้วตรวจบัญชีรับเงิน

    อ่านเลขอ้างอิง ยอดชำระรวม กำหนดชำระ และคำแนะนำโอนเงินของบิลนั้น ส่งสลิปได้เฉพาะเมื่อระบบเปิดรับชำระ อย่าโอนไปยังบัญชีจากข้อความอื่น

  5. ส่งสลิปและติดตามการจัดสรรสิทธิ์

    เลือกช่องทางเดิม BANK_TRANSFER หรือ PROMPTPAY และภาพ JPEG, PNG หรือ WebP ไม่เกิน 10 MiB ตรวจใบเสร็จและวันเริ่ม–สิ้นสุดหลังระบบจัดสรรสำเร็จ เก็บภาพต้นฉบับไว้จนรายการจบ

เปิดเครดิตและใบแจ้งหนี้ใน Merchant Portal ↗
ออกบิลได้ ไม่ได้แปลว่าเปิดรับชำระแล้ว

ปุ่มซื้อแพ็กเกจและส่งสลิปขึ้นกับบริการที่เปิดใช้งานและการยืนยันบัญชีผู้รับ การทดสอบในเครื่องไม่ยืนยันการรับชำระจริง เมื่อระบบแจ้งยังไม่พร้อมให้ติดต่อทีมงานก่อนโอน

รอบใช้งานและโควตารายเดือน

ซื้อใหม่หรือเริ่มหลังหมดอายุ

เมื่อยืนยันใบเสร็จและจัดสรรสำเร็จ ระบบเริ่มรอบใช้งานใหม่และให้โควตาหนึ่งเดือน เครดิตเติมถาวรยังคงอยู่ โควตาแพ็กเกจเก่าที่หมดรอบไม่สะสมเข้าสู่รอบใหม่

ชำระรายปี

ซื้อช่วงเวลาใช้งานหนึ่งปี แต่รับโควตาเป็นรายเดือน ไม่ได้รับเครดิตสิบสองเดือนทันที การรีเซ็ตเดือนถัดไปเป็นไปตามวันครบรอบในเวลาไทย

ต่ออายุก่อนหมดรอบ

รอบที่ซื้อเพิ่มเริ่มจากวันสิ้นสุดเดิม คงเครดิตที่เหลือและโควตาที่ใช้แล้วในเดือนปัจจุบัน ค่า creditsGrantedNow เป็น 0 จึงไม่ใช่ข้อผิดพลาดหรือเครดิตหาย

ต่ออายุด้วยตนเองได้เฉพาะแพ็กเกจเดิมในราคาปัจจุบัน สิทธิ์ที่ชำระแล้วถูกเก็บตามบิลเดิม หากต้องการเปลี่ยนแผนขณะยังมีรอบชำระอยู่ หรือแพ็กเกจเดิมไม่มีวันสิ้นสุด ให้ทีมงานตรวจหลักฐานและรอบใช้งานก่อน

โควตาที่ใช้แล้วนับเฉพาะเครดิตรายเดือนที่หักจากรายการตรวจผ่าน ไม่รวมเครดิตเติมถาวร การตรวจไม่ผ่านไม่ใช้โควตาและคืนเครดิตที่จองไว้ การต่ออายุล่วงหน้าไม่รีเซ็ตการใช้ของเดือนปัจจุบัน

เมื่อแพ็กเกจหมดอายุ โควตารายเดือนหยุดใช้และไม่เพิ่มสาขาหรือ LINE OA ใหม่ รายการที่จองเครดิตก่อนหมดอายุยังทำงานต่อได้ ข้อมูลเดิมยังอ่าน แก้รายละเอียด หรือปิดใช้งานได้ ระบบไม่ลบสาขาหรือประวัติอัตโนมัติ

อ่านสถานะบิลและใบเสร็จ

  1. 1ออกใบแจ้งหนี้
  2. 2ยืนยันใบเสร็จ
  3. 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 ไม่ใช่การรับเงินจากลูกค้าหรือปิดออเดอร์ของร้าน

เส้นทางออกบิลสำหรับเจ้าของร้าน
MethodPathการใช้งาน
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 หรือรหัสผ่านให้ลูกค้าหรือใส่ในข้อความขอความช่วยเหลือ