แนวคิดหลัก

หน้านี้อธิบายคำที่พบบ่อยในหน้าเว็บจัดการและใน Partner API ถ้าต้องการคำแปลไทย–อังกฤษทั้งหมด ดูที่ อภิธานศัพท์

พาร์ทเนอร์และกลุ่มพาร์ทเนอร์

พาร์ทเนอร์ (partner) คือบัญชีธุรกิจหนึ่งบัญชีในระบบ มีรหัสพาร์ทเนอร์ ยอดคงเหลือ คีย์ API และทีมงานของตัวเอง

กลุ่มพาร์ทเนอร์ (partner group) ใช้รวมพาร์ทเนอร์หลายบัญชีที่มีเจ้าของเดียวกัน ผู้ใช้ระดับกลุ่มจะเห็นรายการและยอดของทุกพาร์ทเนอร์ในกลุ่ม

ผู้ชำระเงิน

ผู้ชำระเงิน (payer) คือลูกค้าของคุณ หนึ่งรายการผู้ชำระเงินผูกกับบัญชีธนาคารหนึ่งบัญชี (ธนาคาร เลขที่บัญชี ชื่อบัญชีภาษาไทย และชื่อภาษาอังกฤษถ้ามี)

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

• ผู้ชำระเงินที่มีสถานะ ปิดใช้งาน ทำรายการไม่ได้
• ผู้ชำระเงินหนึ่งรายมีรายการรับเงินที่รอชำระได้ครั้งละหนึ่งรายการ และรายการจ่ายเงินที่ยังไม่จบได้ครั้งละหนึ่งรายการ
• ผู้ชำระเงินที่อยู่ใน รายชื่อระงับ ของผู้ให้บริการจะถูกปฏิเสธเมื่อสร้างหรือทำรายการ

รายการรับเงินและจ่ายเงิน

คำ	ความหมาย
รับเงิน (pay-in)	ผู้ชำระเงินโอนเงินเข้ามา เมื่อสำเร็จ ยอดหักค่าธรรมเนียมจะเข้ายอดคงเหลือของคุณ
จ่ายเงิน (payout)	ระบบโอนเงินจากยอดคงเหลือของคุณไปยังบัญชีของผู้ชำระเงิน
ยอดที่ผู้ชำระเงินขอ	ยอดที่คุณส่งมาตอนสร้างรายการ
ยอดที่โอนจริง	ยอดที่ผู้ชำระเงินต้องโอน (รวมเศษสตางค์ที่ระบบเพิ่ม) หรือยอดที่ระบบโอนออก
เลขคำสั่งซื้อพาร์ทเนอร์	เลขอ้างอิงของคุณเอง (reference ใน API) ใช้ค้นหารายการได้
UUID	รหัสรายการในหน้าเว็บจัดการ

ทุกรายการมี สถานะ ดูความหมายและชื่อสถานะใน API ที่ ตารางสถานะ

ยอดคงเหลือและยอดพร้อมใช้

คำ	ความหมาย
ยอดคงเหลือ	ยอดเงินทั้งหมดในบัญชีพาร์ทเนอร์ของคุณ
ยอดพร้อมใช้	ยอดคงเหลือหักยอดที่ถูกกันไว้ ใช้จ่ายเงินหรือถอนยอดได้ทันที
ถอนยอด (withdrawal)	ขอโอนเงินจากยอดคงเหลือออกไปยังบัญชีธนาคารหรือกระเป๋าคริปโตของบริษัทคุณ
เติมยอด (add funds)	โอนเงินเข้ามาเพิ่มยอดคงเหลือ เช่น เพื่อให้มีเงินพอจ่ายเงินให้ผู้ชำระเงิน

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

ค่าธรรมเนียม

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

ผู้แนะนำ

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

การแจ้งผล (webhook)

เมื่อรายการเปลี่ยนเป็นสถานะสุดท้าย เช่น สำเร็จ หมดเวลา หรือยกเลิก ระบบจะส่งการแจ้งผล (webhook หรือ callback) ไปยัง URL ที่คุณระบุตอนสร้างรายการ ในหน้าเว็บจัดการเรียกส่วนนี้ว่า ประวัติ Callback และกด ส่งแจ้งผลอีกครั้ง ได้ ดูวิธีรับและตรวจลายเซ็นใน Webhook

หมายเหตุ

URL สำหรับแจ้งผลกำหนดต่อรายการตอนสร้างรายการผ่าน API ไม่มีการตั้งค่า URL กลางในหน้าเว็บจัดการ

รหัสอ้างอิง

ข้อความแจ้งข้อผิดพลาดในหน้าเว็บจัดการจะลงท้ายด้วย รหัสอ้างอิง (เช่น req_GJZe...) และทุก response ของ API มี requestId แบบเดียวกัน แจ้งรหัสนี้เมื่อติดต่อฝ่ายสนับสนุน ทีมงานจะหาคำขอนั้นได้ทันที