คู่มือการใช้งาน — พอร์ทัลร้านค้า (Merchant Portal)

แพลตฟอร์มโอนเงินแบบ P2P · ฉบับภาษาไทย

หมายเหตุเรื่องภาพหน้าจอ: ภาพหน้าจอทั้งหมดในคู่มือนี้เป็น ภาษาอังกฤษ (ตรงกับที่จับภาพจากระบบ) ชื่อเมนูและปุ่มบนหน้าจอจึงคงไว้เป็นภาษาอังกฤษเพื่อให้ท่านค้นหาได้ตรงกับที่เห็นจริง ส่วนคำอธิบายเป็นภาษาไทย

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

คู่มือนี้ยึด มุมมองผู้ปฏิบัติงานเป็นหลัก (operator-first) โดยเริ่มจากขั้นตอนการทำงานประจำวันก่อน ส่วนหัวข้อทางเทคนิคสำหรับการเชื่อมต่อระบบ — API key, partner API และ webhooks — อยู่ใน ภาคผนวก A — สำหรับนักพัฒนาและการเชื่อมต่อ

สารบัญ

• ก่อนเริ่มใช้งาน — แนวคิดหลัก
• 1. การเข้าสู่ระบบ
• 2. แดชบอร์ดของท่าน
• 3. ธุรกรรม (Transactions)
• 4. การถอนเงิน (Withdrawals)
• 5. การตรวจสลิป (Slip review)
• 6. ผู้ใช้ (Users)
• 7. การเรียกเก็บค่าบริการและเครดิตการใช้งาน
• 8. การตั้งค่า (Settings)
• 9. ร้านค้าย่อย (Sub-merchants)
• 10. ทีมงาน (Team)
• 11. การให้สิทธิ์ลำดับความสำคัญ (Priority grants)
• ภาคผนวก A — สำหรับนักพัฒนาและการเชื่อมต่อ
• ภาคผนวก B — อภิธานศัพท์

หมายเหตุสำหรับฉบับนี้: บางหน้าจอเป็นฟีเจอร์ที่ยังพัฒนาไม่เสร็จ ซึ่งจะมีป้ายกำกับ อยู่ระหว่างพัฒนา ชัดเจนทุกจุดที่ปรากฏ สิ่งที่ถูกกำกับไว้เช่นนั้นยังไม่รับประกันว่าจะบันทึกการเปลี่ยนแปลงได้

ก่อนเริ่มใช้งาน — แนวคิดหลัก

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

แพลตฟอร์มไม่เคยถือเงินเลย แพลตฟอร์มทำหน้าที่เป็นบัญชีแยกประเภท (ledger) และตัวจับคู่ (matchmaker) เท่านั้น เมื่อมีการดำเนินการถอนเงิน เงินจะเคลื่อนย้าย จากธนาคารสู่ธนาคารระหว่างบุคคลสองฝ่าย โดยตรง แพลตฟอร์มเพียงบันทึกรายการ ไม่เคยแตะต้องตัวเงิน ด้วยเหตุนี้ "การดำเนินการถอนเงิน (fulfilling a withdrawal)" จึงหมายถึง การอัปโหลดหลักฐานการโอนที่เกิดขึ้นแล้ว (โดยท่านหรือโดยผู้ขายที่จับคู่ได้) ไม่ใช่การกดปุ่ม "ส่งเงิน"

เงินฝากกลายเป็นเครดิต ส่วนการถอนคือการใช้เครดิตนั้น

• การฝาก (deposit) จะเพิ่มเครดิตเข้ากระเป๋าเงินของผู้ใช้ในพูลร้านค้าของท่าน ลูกค้าชำระเงินเข้าบัญชีธนาคาร (หรือผ่านเพย์เมนต์เกตเวย์) แล้วอัปโหลดสลิป เมื่อสลิปได้รับการตรวจยืนยันแล้ว เครดิตจึงเข้า
• การถอน (withdrawal) คือการใช้เครดิตนั้น แพลตฟอร์มจะจับคู่รายการ คู่สัญญาอีกฝ่ายโอนเงินสด แล้วท่าน (หรือแพลตฟอร์ม) ยืนยันด้วยสลิป

ชนิดของเครดิต — ท่านจะเห็นค่าเหล่านี้บนยอดคงเหลือของผู้ใช้:

• REAL — เครดิตจริงที่ถอนได้ เป็นสิ่งที่การจับคู่และการคิดค่าบริการยึดเป็นหลัก
• POINT — เครดิตส่งเสริมการขายที่ถอนไม่ได้ กำหนดผ่าน API และไม่เข้าสู่กระบวนการจับคู่
• PLATFORM_CREDIT — พูลแยกต่างหาก ดำเนินการโดยผู้ดูแลระบบ (admin) เท่านั้น

วงจรชีวิตของการฝาก — สถานะที่ท่านจะเห็นบนธุรกรรม:

สร้างการจอง (Reservation created) → รอสลิป → อัปโหลดสลิปแล้ว → กำลังตรวจยืนยัน → ชำระเสร็จ (settled) (เครดิตเข้า)

การฝากอาจเข้ามา เกิน (over) จำนวนที่จองไว้ (ระบบให้เครดิตเฉพาะจำนวนที่จอง ส่วนเกินจะถูกทำเครื่องหมายไว้) หรือ ขาด (under) (ให้เครดิตเฉพาะจำนวนที่เข้าจริง)

ใครทำอะไรได้บ้าง — บทบาทของพนักงาน ทุกการกระทำในคู่มือนี้ถูกจำกัดตามบทบาท:

1. การเข้าสู่ระบบ

การเข้าสู่ระบบมีสองขั้นตอนทุกครั้ง สำหรับพนักงานทุกคน:

1. อีเมล + รหัสผ่าน ที่ /merchant/login
2. รหัส 6 หลัก จากแอปยืนยันตัวตน (Google Authenticator, Authy, 1Password ฯลฯ)

เข้าใช้งานครั้งแรกใช่ไหม? หากเจ้าของบัญชี (owner) หรือรีเซลเลอร์ของท่านเชิญท่านเข้ามา การเข้าสู่ระบบครั้งแรกจะใช้รหัสผ่านชั่วคราวและพาท่านทำ ขั้นตอนเริ่มต้นใช้งาน (onboarding): ตั้งรหัสผ่านถาวร (อย่างน้อย 12 ตัวอักษร มีทั้งตัวอักษรและตัวเลข) สแกน QR code สำหรับ TOTP ด้วยแอปยืนยันตัวตน แล้วยืนยันรหัส จากนั้นท่านจะเข้าสู่แดชบอร์ด

ทำแอปยืนยันตัวตนหายหรือ? เจ้าของบัญชีสามารถรีเซ็ตข้อมูลรับรองของท่านได้จากเมนู Team (ดู หัวข้อ 10) ระบบจะออกรหัสผ่านชั่วคราวใหม่และล้าง 2FA เพื่อให้ท่านลงทะเบียนใหม่ได้

2. แดชบอร์ดของท่าน

แดชบอร์ดคือมุมมองการปฏิบัติงานแบบเห็นภาพรวมได้ทันที แสดงจำนวนรายการที่ต้องจัดการ — การถอนที่รอดำเนินการ (pending withdrawals), การดำเนินการที่รออยู่ (pending fulfilments), เครดิตแพลตฟอร์มที่ใช้ได้ (available platform credit) และ การให้สิทธิ์ลำดับความสำคัญ (priority grants) ล่าสุด โดยแต่ละการ์ดเชื่อมตรงไปยังคิวที่เกี่ยวข้อง

3. ธุรกรรม (Transactions)

Transactions (/merchant/transactions) คือฟีดการเดินเงินทั้งหมดของพูลท่าน ค้นหาด้วยรหัส จำนวนเงิน หรือเบอร์โทรศัพท์ กรองตามประเภท (การฝาก, ขาการฝาก (deposit legs), การถอน และอื่น ๆ) และตามช่วงวันที่ เจ้าของบัญชียังเจาะดูตาม ร้านค้าย่อย (sub-merchant) ได้อีกด้วย

การกระทำในแต่ละแถวขึ้นอยู่กับประเภทของธุรกรรม:

• การฝาก / การจอง (deposit / reservation) จะมี Cancel & release — คืนการจองที่ค้างไว้ และปลดการผูกกับการถอนที่จับคู่ไว้
• การถอน (withdrawal) จะมี Fulfil — ดู หัวข้อ 4

รายละเอียดธุรกรรม

การเปิดธุรกรรมจะแสดงภาพรวมทั้งหมด: รายการในบัญชีแยกประเภท (ledger entry), ภาพสลิป ที่อัปโหลดพร้อมข้อมูลผู้ส่งและผู้รับที่อ่านได้, บัญชีธนาคารปลายทาง (แสดงแบบปิดบัง), และรายการ เงินฝากที่นำมาชำระ (funding deposits) ที่ทำให้รายการนี้สมบูรณ์ มีสองสัญญาณที่ควรทราบ:

• เกินวงเงิน (over-cap) — ผู้จ่ายส่งเงิน มากกว่า ที่จองไว้ ระบบให้เครดิตเฉพาะจำนวนที่จอง ส่วนเกินจะถูกบันทึกไว้เพื่อการกระทบยอดของท่าน
• ต่ำกว่าวงเงิน (under-cap) — ผู้จ่ายส่ง น้อยกว่า ระบบให้เครดิตเฉพาะที่เข้าจริง ส่วนที่ขาดถือว่าไม่เคยได้รับ

4. การถอนเงิน (Withdrawals)

คิว Withdrawals แสดงคำสั่งถอนที่รอดำเนินการ เรียงตามระดับลำดับความสำคัญ (priority tier) แต่ละแถวแสดงจำนวนเงิน ลูกค้าที่ถอน (ระบุด้วยรหัสผู้ใช้ของท่านเอง) ป้ายร้านค้าย่อย (ถ้ามี) และวันที่ร้องขอ

การดำเนินการถอนเงิน

การดำเนินการเป็นทางเลือกแบบ สลิปหรือข้าม (slip-or-bypass) — ทำอย่างใดอย่างหนึ่งเท่านั้น:

• อัปโหลดสลิปหลักฐาน — ใบเสร็จการโอนเงินที่แสดงว่าเงินถึงลูกค้าแล้ว
• ข้ามพร้อมระบุเหตุผล (bypass with a reason) — สำหรับการชำระที่ทำนอกกระบวนการสลิปปกติ (เช่น การจ่ายเงินสด) ท่านต้องบันทึกเหตุผลไว้

การถอนรองรับ การเติมบางส่วน (partial fills): หากท่านดำเนินการน้อยกว่าจำนวนเต็ม ส่วนที่เหลือจะกลับเข้ากระเป๋าเงินของลูกค้า และท่านสามารถใช้ early-success เพื่อปิดการถอนบางส่วนที่ท่านพอใจแล้วได้ การดำเนินการทุกครั้งจะแจ้งระบบของท่านผ่าน webhook withdraw.notify

5. การตรวจสลิป (Slip review)

Slip review คือที่ที่ท่านตรวจสอบหลักฐานการฝาก มีสองส่วน — reservations (เงินฝากตรง) และ legs (เงินฝากที่ถูกแบ่งไปยังหลายบัญชี) การควบคุมหลักของท่านที่นี่คือการ ปฏิเสธ (reject) สลิปที่ไม่ผ่าน (พร้อมเหตุผล) ส่วนการอนุมัติสลิปทั่วไปเป็นหน้าที่ของผู้ดูแลระบบ โดยมีข้อยกเว้นบางกรณีที่ท่านทำได้: การอนุมัติแบบรับรอง (attestation) และการตัดสินกรณีเกินวงเงิน

เครื่องมือที่มีในแต่ละรายการ:

• Re-verify — หากอ่าน QR หรือใบเสร็จไม่ได้ ให้รันการดึงข้อมูลใหม่หลังอัปโหลดภาพที่ชัดกว่า
• Late-slip upload — หากการจองหมดอายุก่อนที่ลูกค้าจะส่งหลักฐาน อัปโหลดสลิปที่ส่งช้าเพื่อกู้คืนเป็นเงินฝากใหม่ที่ตรวจสอบได้

ผลการให้คะแนน (Score findings)

Score findings (ในแถบด้านข้างชื่อ "Score findings") แสดงสลิปที่ได้คะแนนความเชื่อมั่นต่ำจากการตรวจ QR/OCR อัตโนมัติ — โดยแสดงแหล่งที่มา ผู้ฝาก คะแนนความเชื่อมั่น และจำนวนช่องข้อมูลที่ไม่ตรงกัน กรองด้วย For review, Reviewed หรือ All และ Mark reviewed เพื่อบันทึกว่าท่านรับทราบผลนั้นแล้ว

6. ผู้ใช้ (Users)

Users แสดงลูกค้าที่เชื่อมโยงกับร้านค้าของท่าน ค้นหาด้วยอีเมล ชื่อที่แสดง หรือรหัสผู้ใช้ของท่านเอง จากที่นี่ท่านยังทำสิ่งต่อไปนี้ได้:

• ออกลิงก์สมัคร (signup links) — ลิงก์ใช้ครั้งเดียวที่เชื่อมลูกค้าเข้ากับร้านค้าของท่าน (ออกซ้ำได้)
• เพิกถอนความยินยอม (revoke consent) — ตัดการเชื่อมโยงผู้ใช้ (ท่านจะพิมพ์ REVOKE เพื่อยืนยัน)

รายละเอียดผู้ใช้

[รอภาพหน้าจอที่มีข้อมูล — หน้ารายละเอียดผู้ใช้อธิบายไว้ด้านล่าง แต่ยังไม่มีภาพหน้าจอจากชุดข้อมูลตัวอย่างของร้านค้านี้]

หน้าของผู้ใช้จะแสดงโปรไฟล์ กระเป๋าเงินหลายพูล (multi-pool wallet) (ยอด REAL / POINT / PLATFORM_CREDIT) และการถอนล่าสุด เลขบัญชีธนาคารจะถูกปิดบังเหลือ 4 หลักท้าย ผู้ใช้ระดับ OPERATOR หรือ OWNER สามารถ เปิดเผย (reveal) เลขเต็มได้ ซึ่งเป็นการกระทำที่ถูกบันทึกในบันทึกตรวจสอบ (audit log)

⚠️ หมายเหตุสำหรับระบบจริง (production): การเปิดเผยเลขบัญชีธนาคารเต็มใช้ได้ในสภาพแวดล้อมการพัฒนา แต่ปัจจุบัน ถูกปิดกั้นในระบบจริง โดยรอบริการจัดการกุญแจ KMS (ADR-0102)

7. การเรียกเก็บค่าบริการและเครดิตการใช้งาน

Billing แสดงการใช้งานของท่านและค่าบริการที่คำนวณจากการใช้งานนั้น ตามเวลากรุงเทพฯ (GMT+7) การ์ดหัวสองใบแสดงการใช้งานและค่าบริการของ วันนี้ และ ตั้งแต่ต้นเดือนถึงปัจจุบัน (month-to-date) ด้านล่างมีตัวสลับระดับความละเอียด (ชั่วโมง / วัน / สัปดาห์ / เดือน) และช่วงวันที่ที่ควบคุมตารางบัญชีแยกประเภท ค่าบริการคำนวณ ณ เวลาที่อ่านข้อมูลจากตารางอัตราที่มีผลของท่าน

เครดิตการใช้งาน (Usage credit)

Usage credit คือยอดคงเหลือแบบเติมล่วงหน้าที่แพลตฟอร์มใช้หักค่าบริการของท่าน การ์ดแสดงยอดปัจจุบัน เกณฑ์เตือนยอดต่ำ และกิจกรรมล่าสุด ใช้ Top-up request เพื่อเพิ่มเครดิต (ผู้ดูแลระบบจะตรวจสอบ) ตารางประวัติบันทึกทุกการเติม การหัก และการปรับปรุง

8. การตั้งค่า (Settings)

Settings แสดงการกำหนดค่าร้านค้าของท่าน — ชื่อที่แสดง, slug, สถานะ, URL ของ webhook, อัตราจำกัดคำขอ (rate limit) และการยอมรับ DPA ส่วนใหญ่จัดการโดยผู้ดูแลระบบ ส่วนหน้าย่อยด้านล่างคือส่วนที่เจ้าของบัญชีของท่านควบคุมได้

บัญชีธนาคาร (Bank accounts)

พูลกำหนดเส้นทาง (routing pool) ของท่านคือชุดบัญชีธนาคารที่เงินฝากของลูกค้าถูกส่งไปแบบวนรอบ เจ้าของบัญชีสามารถเปิด/ปิดใช้งานบัญชี และแก้ไขบัญชีของท่านเองได้ ส่วนการเพิ่มบัญชีใหม่ทำโดยผู้ดูแลระบบ

เพย์เมนต์เกตเวย์ (Payment gateways)

หากเงินฝากของท่านผ่านเพย์เมนต์เกตเวย์ หน้านี้จะแสดงข้อมูลรับรองของเกตเวย์ สถานะ และช่องเส้นทางที่จับคู่ไว้ เจ้าของบัญชีสามารถเปิด/ปิดใช้งาน และเปลี่ยนป้ายชื่อที่แสดงได้ ระบบไม่แสดงความลับ (secret) ใด ๆ

เกณฑ์ลำดับความสำคัญ (Priority thresholds)

ชุดจำนวนเงินสี่ระดับที่เพิ่มขึ้นอย่างเข้มงวด (strictly-increasing) ใช้จำแนกว่าเงินฝากใดได้รับการจัดวางแบบมีลำดับความสำคัญ

⚠️ อยู่ระหว่างพัฒนา: หน้าตั้งค่านี้ยังอยู่ระหว่างการพัฒนา (Phase C) และอาจยังไม่รับการเปลี่ยนแปลง

9. ร้านค้าย่อย (Sub-merchants)

หากท่านขายต่อให้ธุรกิจปลายทางของท่านเอง เมนู Sub-merchants ให้เจ้าของบัญชีสร้างและติดตามร้านค้าเหล่านั้นได้ ร้านค้าย่อยแต่ละรายมีรหัสเฉพาะ ชื่อที่แสดง และยอดเครดิตการใช้งานของตนเอง ซึ่งท่านจัดสรรจากพูลของบริษัทแม่ ท่านสามารถกรองธุรกรรมและผู้ใช้ตามร้านค้าย่อยได้ทั่วทั้งพอร์ทัล

10. ทีมงาน (Team)

Team คือที่ที่เจ้าของบัญชีจัดการพนักงาน เชิญสมาชิกใหม่ (ระบบจะแสดงข้อมูลรับรองใช้ครั้งเดียวพร้อม QR code สำหรับ TOTP เพื่อส่งมอบ) เปลี่ยนบทบาทของสมาชิก หรือรีเซ็ตข้อมูลรับรองของสมาชิก มีการป้องกันไว้: ท่านเปลี่ยนบทบาทของตัวเองไม่ได้ และล็อกเจ้าของบัญชีคนสุดท้ายออกไม่ได้

11. การให้สิทธิ์ลำดับความสำคัญ (Priority grants)

Priority grants แสดงการกำหนดลำดับความสำคัญเฉพาะรายผู้ใช้ (per-user overrides)

⚠️ อยู่ระหว่างพัฒนา: การสร้างและเพิกถอนสิทธิ์ยังไม่เปิดใช้งาน (Phase C) ขณะนี้รายการเป็นแบบดูอย่างเดียว

ภาคผนวก A — สำหรับนักพัฒนาและการเชื่อมต่อ

หน้าจอเหล่านี้มีไว้สำหรับวิศวกรที่เชื่อมต่อระบบของท่านเข้ากับแพลตฟอร์ม ผู้ปฏิบัติงานฝ่ายธุรกิจสามารถข้ามภาคผนวกนี้ได้

API key และ HMAC secret

หน้านี้แสดง ลายนิ้วมือ (fingerprint) ของ API key (ไม่เคยแสดงกุญแจเต็ม) และให้ หมุน (rotate) ทั้ง API key และกุญแจลงนาม HMAC เมื่อหมุน ค่าใหม่จะแสดง เพียงครั้งเดียว — คัดลอกทันที ค่าเก่าและค่าใหม่จะใช้ได้ทั้งคู่เป็นเวลา 24 ชั่วโมง เพื่อให้ท่านทยอยเปลี่ยนได้โดยไม่มีช่วงหยุดทำงาน

คอนโซลทดสอบการเชื่อมต่อ (Integration test)

พื้นที่ทดลองสำหรับนักพัฒนา มีสองแท็บ:

• Webhooks — ยิงเหตุการณ์จำลองไปยัง URL webhook ของท่าน โดยลงนามด้วยลายเซ็น HMAC จริง เพื่อทดสอบตัวรับของท่าน
• API — เรียก partner API จากเบราว์เซอร์โดยตรงด้วย API key ของท่าน พร้อมเอกสารอ้างอิงเรียงตามลำดับการทำงาน และตัวสร้างพรอมป์ต์สำหรับ LLM เพื่อช่วยต่อการเชื่อมต่อ

บันทึกการส่ง webhook

บันทึกการส่งทั้งหมด — ทั้งเหตุการณ์ที่ ส่งสำเร็จ (delivered) และ ล้มเหลว (failed) กรองตามสถานะ ประเภทเหตุการณ์ และวันที่ มีสองการกระทำในการส่งใหม่:

• Retry — เข้าคิวส่งรายการเดิมที่ล้มเหลวอีกครั้ง
• Resend — คัดลอกเหตุการณ์ที่ส่งสำเร็จแล้วไปเป็นการส่งครั้งใหม่ (รายการเดิมยังคงอยู่)

partner API โดยสรุปในหนึ่งย่อหน้า

ระบบหลังบ้านของท่านเรียก partner API ของแพลตฟอร์มเพื่อสร้างการฝาก การถอน และตรวจสอบยอดคงเหลือ แพลตฟอร์มจะเรียกกลับหาท่านด้วย deposit.notify และ withdraw.notify (การแจ้งเตือนการชำระแบบรวม) และเรียก credit.check แบบซิงโครนัสเพื่อยืนยันยอดคงเหลือของผู้ใช้ก่อนการถอน webhook ขาออกทุกรายการ ลงนามด้วย HMAC-SHA256 — โปรดตรวจสอบลายเซ็นฝั่งท่านด้วย HMAC secret (จำไว้ว่าค่านี้ให้มาเป็น base64 ต้องถอดรหัสเป็นไบต์ดิบก่อนตรวจสอบ) ทุกการเรียกที่เปลี่ยนแปลงข้อมูลต้องใช้ idempotency key

ภาคผนวก B — อภิธานศัพท์

• Reservation (การจอง) — ช่องที่จองไว้สำหรับเงินฝากที่กำลังจะเข้ามา รอสลิปหลักฐานจากลูกค้า
• Leg (ขา) — ส่วนหนึ่งของเงินฝากที่ถูกแบ่งไปยังบัญชีปลายทางหลายบัญชี
• Over-cap / under-cap (เกิน / ต่ำกว่าวงเงิน) — ผู้จ่ายส่งเงินมากกว่า / น้อยกว่าจำนวนที่จองไว้
• Fulfilment (การดำเนินการ) — หลักฐานว่าเงินสดของการถอนได้เคลื่อนย้ายจริง (สลิปหรือการข้ามที่บันทึกไว้)
• Usage credit (เครดิตการใช้งาน) — ยอดเติมล่วงหน้าของท่านที่แพลตฟอร์มหักค่าบริการออก
• Sub-merchant (ร้านค้าย่อย) — ธุรกิจปลายทางที่ท่านขายต่อให้ ติดตามภายใต้ร้านค้าของท่าน
• REAL / POINT / PLATFORM_CREDIT — ชนิดเครดิตสามแบบที่กระเป๋าเงินของผู้ใช้ถือได้