คู่มือการตั้งค่ารีเซลเลอร์ — การนำร้านค้าเข้าระบบแบบครบวงจร

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

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

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

⚠️ อยู่ระหว่างพัฒนา: หน้าจอผู้ให้บริการตรวจสลิปและเพย์เมนต์เกตเวย์ยังอยู่ระหว่างการพัฒนา — ป้ายกำกับช่องกรอกอาจต่างจากที่แสดงไว้เล็กน้อย

สารบัญ

• ก่อนเริ่ม
• 1. สร้างร้านค้า
• 2. สร้างบัญชีเจ้าของร้านค้า
• 3. ตั้งค่าผู้ให้บริการตรวจสลิป (ระดับรีเซลเลอร์)
• 4. ตั้งค่าเพย์เมนต์เกตเวย์
• 5. ตั้งค่าบัญชีธนาคาร (ระดับรีเซลเลอร์)
• ตารางอ้างอิงฉบับย่อ

ก่อนเริ่ม

1. ท่านต้องมีสิทธิ์ผู้ดำเนินการ (operator grant) ขั้นตอนทั้งห้าต้องอาศัยให้รีเซลเลอร์ของท่านได้รับสิทธิ์ "can create merchants" (สร้างร้านค้าได้) ที่เปิดโดยผู้ดูแลระบบแพลตฟอร์ม หากไม่มี หน้าจอเหล่านี้จะแสดงข้อความ "You are not permitted to… Ask an administrator to enable this for your reseller." ให้ขอผู้ดูแลระบบเปิดให้ (admin → Resellers → รีเซลเลอร์ของท่าน → สลับ Can create merchants)

2. ใครทำอะไรได้บ้าง:

3. ระบบเลือกช่องทางอย่างไร (การสืบทอด) สำหรับการตรวจสลิป เพย์เมนต์เกตเวย์ และบัญชีธนาคารแต่ละอย่าง ร้านค้าจะใช้ค่าตั้ง ของตนเอง หากมี มิฉะนั้นใช้ ของท่าน (ระดับรีเซลเลอร์) มิฉะนั้นใช้ ค่าเริ่มต้นของแพลตฟอร์ม:

ร้านค้า → รีเซลเลอร์ → แพลตฟอร์ม

ดังนั้นตั้งค่าระดับรีเซลเลอร์ (ขั้นตอน 3, 4a และ 5) เพียงครั้งเดียว แล้วร้านค้าทุกรายที่ท่านเป็นเจ้าของจะสืบทอดไป — หรือกำหนดทับรายร้านค้า (ขั้นตอน 4b) เมื่อร้านค้าใดต้องการช่องทางของตนเอง

4. Feature flag เพย์เมนต์เกตเวย์ระดับรีเซลเลอร์ (ขั้นตอน 4a) และ บัญชีธนาคาร (ขั้นตอน 5) ของท่านจะมีผลในการกำหนดเส้นทางเงินฝากจริงเฉพาะเมื่อ FEATURE_RESELLER_GATEWAY_TIER เปิดอยู่ (ค่าเริ่มต้นปิดในสภาพแวดล้อมส่วนใหญ่) ส่วน ระดับผู้ให้บริการตรวจสลิป (ขั้นตอน 3) ใช้งานได้เสมอ

1. สร้างร้านค้า

สร้างร้านค้า มอบหมายให้ท่าน กำหนดอัตราค่าธรรมเนียม และมอบข้อมูลรับรอง API ให้ท่าน

ที่ไหน: พอร์ทัลรีเซลเลอร์ → Merchants → Create merchant

ขั้นตอน:

1. Slug — รหัสเฉพาะของร้านค้า 3–64 อักขระ: ตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลาง (เช่น acme-store)
2. Display name — ชื่อร้านค้าที่อ่านได้ (เช่น Acme Store)
3. Webhook URL (HTTPS) — ที่ที่แพลตฟอร์มจะส่ง (POST) เหตุการณ์การชำระ ต้องขึ้นต้นด้วย https://
4. Pay-in rate (%) — ค่าธรรมเนียมเงินฝากที่ร้านค้าจ่าย แบบฟอร์มแสดงขั้นต่ำและส่วนต่างของท่านแบบสด: "Platform base 0.50% · your margin 1.00%" ท่าน ไม่สามารถ ตั้งต่ำกว่าอัตราฐานของแพลตฟอร์ม — อัตราที่ต่ำเกินไปจะแสดง "Below your platform base of 0.20% — raise this rate" เป็นสีแดง
5. Pay-out rate (%) — ค่าธรรมเนียมการถอน ใช้กฎขั้นต่ำเดียวกัน
6. ยอมรับ DPA — ติ๊ก "I accept the platform Data Processing Agreement on behalf of this merchant." ร้านค้าจะ ใช้งานได้ (Active) ก็ต่อเมื่อท่านยอมรับเท่านั้น มิฉะนั้นจะถูกสร้างในสถานะ ถูกระงับ (Suspended)
7. คลิก Create merchant (จะกดได้เมื่อทุกช่องถูกต้อง)

ผลลัพธ์: API key (sen_live_…) และ HMAC secret ของร้านค้าจะแสดง เพียงครั้งเดียว — คัดลอกทันทีและส่งมอบให้ร้านค้าอย่างปลอดภัย ระบบจะไม่แสดงอีก ร้านค้าถูกสร้างแล้วแต่ ยังทำธุรกรรมไม่ได้จนกว่าจะมีช่องทางชำระเงิน (ดูขั้นตอน 4)

ปัญหาที่พบบ่อย:

• อัตราถูกปฏิเสธ → อัตราของท่านต่ำกว่าอัตราฐานของแพลตฟอร์ม ให้เพิ่มขึ้น
• Slug ถูกใช้แล้ว → เลือก slug อื่น
• "Not permitted" → ยังไม่ได้เปิดสิทธิ์ผู้ดำเนินการ (ดู "ก่อนเริ่ม")

2. สร้างบัญชีเจ้าของร้านค้า

มอบบัญชีเข้าสู่ระบบหลังบ้านบัญชีแรกให้ร้านค้า (Merchant Owner) ซึ่งจะสามารถเชิญผู้ดำเนินการและผู้ดูของตนเองต่อได้

ที่ไหน: พอร์ทัลรีเซลเลอร์ → Merchants → เปิดร้านค้า → ส่วน Back-office staff

ขั้นตอน:

1. เปิดร้านค้าจากรายการ Merchants ของท่าน แล้วเลื่อนไปที่ Back-office staff
2. ใต้ Add a staff login กรอก: - Email — อีเมลเข้าสู่ระบบของเจ้าของร้าน - Name — ชื่อ (เช่น John Fulton) - Role — เลือก Owner (full access) (มี Operator และ Viewer ให้เลือกด้วย)
3. คลิก Create login

ผลลัพธ์: รหัสผ่านชั่วคราว จะแสดง เพียงครั้งเดียว — คัดลอกและมอบให้เจ้าของร้าน (พวกเขาจะตั้งรหัสผ่านถาวรและลงทะเบียน 2FA เมื่อเข้าครั้งแรก) จากนั้นเจ้าของร้านจะปรากฏในรายชื่อพนักงานพร้อมปุ่ม Reset credentials หากสูญเสียการเข้าถึง (ออกรหัสผ่านชั่วคราวใหม่ ล้าง 2FA และปิดเซสชันของพวกเขา)

ปัญหาที่พบบ่อย:

• อีเมลถูกใช้แล้ว → อีเมลนั้นมีบัญชีพนักงานสำหรับร้านค้านี้อยู่แล้ว
• "Not permitted" → เป็นสิทธิ์เฉพาะ OWNER และต้องมีสิทธิ์ผู้ดำเนินการ

3. ตั้งค่าผู้ให้บริการตรวจสลิป (ระดับรีเซลเลอร์)

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

ที่ไหน: พอร์ทัลรีเซลเลอร์ → Slip providers

ขั้นตอน:

1. ใน Provision your slip-verify provider key เลือก Provider (เช่น EasySlip, MockBank, HippoPay)
2. กรอก API key (เก็บแบบเข้ารหัส ไม่แสดงอีก)
3. หรือกรอก Base URL (หากเว้นว่างจะใช้ปลายทางมาตรฐานของผู้ให้บริการ)
4. คลิก Provision ขั้นตอนนี้จะหมุนแทนกุญแจที่ใช้งานอยู่เดิมในคราวเดียว
5. ในตาราง คลิก Test เพื่อตรวจการเชื่อมต่อ — วาง QR payload จริง (และจำนวนเงินที่คาดหวังหากต้องการ) แล้ว Run test ท่านจะเห็นผลสำเร็จพร้อมค่าหน่วงเวลา หรือข้อผิดพลาดของผู้ให้บริการ
6. ใช้ Activate / Deactivate เพื่อควบคุมว่ากุญแจใดใช้งานอยู่ หากไม่มีกุญแจที่ใช้งาน ร้านค้าของท่านจะตกไปใช้ค่าเริ่มต้นของแพลตฟอร์ม

ผลลัพธ์: มีผู้ให้บริการที่ใช้งานได้หนึ่งรายต่อรีเซลเลอร์ สืบทอดโดยร้านค้าทุกรายของท่านที่ไม่มีของตนเอง

ปัญหาที่พบบ่อย:

• "Not permitted" → ต้องมี MANAGE_SLIP_PROVIDERS พร้อมสิทธิ์ผู้ดำเนินการ

4. ตั้งค่าเพย์เมนต์เกตเวย์

เพย์เมนต์เกตเวย์คือสิ่งที่ทำให้ร้านค้า รับเงินฝากได้ ท่านตั้งได้ที่ ระดับรีเซลเลอร์ (ร้านค้าทุกรายสืบทอด) หรือ รายร้านค้า (เฉพาะร้านนั้น)

4a. ระดับรีเซลเลอร์ — ร้านค้าทุกรายสืบทอด

ที่ไหน: พอร์ทัลรีเซลเลอร์ → Payment gateways

ขั้นตอน:

1. ใน Provision your payment-gateway account กรอก API key และ API secret (ทั้งคู่เก็บแบบเข้ารหัส ไม่แสดงอีก)
2. หรือเพิ่ม Label (เช่น Primary account) และ Base URL
3. คลิก Provision (หมุนแทนข้อมูลรับรองที่ใช้งานอยู่เดิม)
4. คลิก Test ที่แถวเพื่อตรวจการเชื่อมต่อ — ท่านจะเห็นยอดคงเหลือของเกตเวย์พร้อมค่าหน่วงเวลา หรือข้อผิดพลาด
5. ใช้ Activate / Deactivate เพื่อควบคุมว่าข้อมูลรับรองใดใช้งานอยู่

⚠️ อย่าลืม feature flag: เกตเวย์ระดับรีเซลเลอร์จะเข้าสู่การกำหนดเส้นทางเงินฝากจริงก็ต่อเมื่อ FEATURE_RESELLER_GATEWAY_TIER เปิดอยู่

4b. รายร้านค้า — เฉพาะร้านนี้

ที่ไหน: พอร์ทัลรีเซลเลอร์ → Merchants → เปิดร้านค้า → ส่วน Payment gateway (ดูภาพหน้าจอในขั้นตอน 2 — คอลัมน์ขวา: "Register the payment rail so this merchant can accept deposits.")

ขั้นตอน:

1. เปิดร้านค้า ในส่วน Payment gateway สังเกตสถานะ ("No payment gateway registered yet — this merchant cannot take payments until one is added.")
2. ใต้ Register a PGWAY gateway กรอก API key, API secret และ Label กับ Base URL (หากต้องการ)
3. คลิก Register
4. ใช้ Activate / Deactivate ที่แถวที่มีอยู่เพื่อควบคุมข้อมูลรับรองที่ใช้งาน

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

ปัญหาที่พบบ่อย:

• "Not permitted" → รายร้านค้าเป็นสิทธิ์เฉพาะ OWNER ทั้งสองระดับต้องมีสิทธิ์ผู้ดำเนินการ

5. ตั้งค่าบัญชีธนาคาร (ระดับรีเซลเลอร์)

เพิ่มบัญชีธนาคารเข้าพูลรีเซลเลอร์ของท่าน เงินฝากที่กำหนดเส้นทางผ่านช่องทางรีเซลเลอร์ของท่านสามารถเข้าที่นี่ได้

ที่ไหน: พอร์ทัลรีเซลเลอร์ → Bank accounts

ขั้นตอน:

1. ใน Add your bank account เลือก Bank (รายชื่อธนาคารไทย เช่น Kasikornbank / KBANK)
2. กรอก Account holder name (เช่น ชื่อบริษัทของท่าน)
3. กรอก Account number (ตัวเลข 6–32 อักขระ)
4. คลิก Add account บัญชีของท่านจะ ได้รับการรับรองทันที (vouched) (ตรวจสอบแล้ว) และเข้าร่วมพูลของท่าน
5. ใช้ Activate / Deactivate เพื่อรวม/ไม่รวมบัญชีในการกำหนดเส้นทาง (การไล่ลำดับจะวนรอบบัญชีที่ใช้งานอยู่และข้ามบัญชีที่ปิดใช้)

⚠️ Feature flag: บัญชีเหล่านี้จะรับเงินฝากผ่านขาของรีเซลเลอร์ในการไล่ลำดับก็ต่อเมื่อ FEATURE_RESELLER_GATEWAY_TIER เปิดอยู่

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

ปัญหาที่พบบ่อย:

• ซ้ำ → ธนาคารพร้อมเลขบัญชีนั้นมีอยู่ในพูลของท่านแล้ว
• "Not permitted" → ต้องมีสิทธิ์ผู้ดำเนินการช่องทางเงินฝากพร้อมสิทธิ์ผู้ดำเนินการ

ตารางอ้างอิงฉบับย่อ

ทั้งหกข้อต้องมี: สถานะรีเซลเลอร์ ACTIVE พร้อมสิทธิ์แพลตฟอร์ม can create merchants ส่วน เกตเวย์ระดับรีเซลเลอร์ (4a) และ บัญชีธนาคาร (5) ยังต้องเปิด FEATURE_RESELLER_GATEWAY_TIER เพื่อให้มีผลกับการกำหนดเส้นทางจริง