Sub-Merchants API
Sub-Merchants API ช่วยให้คุณจัดการ sub-merchants สำหรับบัญชีตลาดกลางและแพลตฟอร์ม Sub-merchants แทนผู้ขาย ผู้จำหน่าย หรือผู้ให้บริการที่ประมวลผลการชำระเงินผ่านแพลตฟอร์มของคุณ
ภาพรวม
Sub-merchants ช่วยให้คุณสามารถ:
- เพิ่มผู้ขายและผู้จำหน่าย เข้าสู่แพลตฟอร์มของคุณโดยอัตโนมัติ
- แบ่ งการชำระเงิน ระหว่างแพลตฟอร์มและ sub-merchants
- จัดการรายละเอียดร้านค้า รวมถึงข้อมูลธุรกิจและบัญชีธนาคาร
- ติดตามธุรกรรม สำหรับแต่ละ sub-merchant แยกกัน
- ปฏิบัติตามกฎระเบียบ โดยการเก็บรักษาบันทึกร้านค้าอย่างเหมาะสม
ประเภท Sub-Merchant
Sub-Merchants บุคคลธรรมดา
บัญชีส่วนบุคคลสำหรับผู้ขายรายบุคคล ต้องการ:
- ชื่อ-นามสกุลตามกฎหมาย
- หมายเลขบัตรประชาชนหรือหนังสือเดินทาง
- รายละเอียดบัญชีธนาคาร
- ข้อมูลติดต่อ
Sub-Merchants ธุรกิจ
บัญชีบริษัทหรือธุรกิจ ต้องการ:
- ชื่อธุรกิจที่จดทะเบียน
- หมายเลขทะเบียนธุรกิจ
- หมายเลขประจำตัวผู้เสียภาษี
- รายละเอียดบัญชีธนาคาร
- ข้อมูลผู้มีอำนาจลงนาม
วงจรชีวิต Sub-Merchant
- สร้าง - ลงทะเบียน sub-merchant ใหม่พร้อมรายละเอียดธุรกิจที่จำเป็น
- รอดำเนินการ - Sub-merchant อยู่ระหว่างการตรวจสอบและตรวจความสอดคล้อง
- ใช้งาน - Sub-merchant สามารถรับการชำระเงินผ่านแพลตฟอร์มของคุณ
- ถูกระงับ - ถูกปิดใช้งานชั่วคราว (ปัญหาความสอดคล้อง คำขอ เป็นต้น)
- ปิดใช้งาน - ถูกลบออกจากแพลตฟอร์มอย่าง ถาวร
ข้อกำหนดแพลตฟอร์ม
ในการใช้ Sub-Merchants API บัญชีของคุณต้อง:
- ได้รับการอนุมัติเป็นบัญชีแพลตฟอร์ม/ตลาดกลาง
- เปิดใช้งานการจัดการ sub-merchant
- ปฏิบัติตามกฎระเบียบการชำระเงินในท้องถิ่น
- มีขั้นตอน KYC/AML ที่เหมาะสม
ติดต่อฝ่ายสนับสนุน Omise เพื่อเปิดใช้งานฟีเจอร์แพลตฟอร์มในบัญชีของคุณ
ขั้นตอนการชำระเงิน
การชำระเงินตรง
การชำระเงินจะถูกส่งต รงไปยัง sub-merchants โดยค่าธรรมเนียมแพลตฟอร์มจะถูกหักโดยอัตโนมัติ
การแบ่งการชำระเงิน
การชำระเงินจะถูกแบ่งระหว่างแพลตฟอร์มและ sub-merchant ตามกฎที่กำหนดไว้
การชำระเงินรวม
ธุรกรรมหลายรายการจะถูกรวมก่อนการชำระเงินเพื่อลดค่าใช้จ่ายในการโอน
การยืนยันตัวตน
ทุก endpoint ของ sub-merchant ต้องใช้ secret key ของคุณสำหรับการยืนยันตัวตน อย่าเปิดเผย secret key ของคุณในโค้ดฝั่ง client
Endpoints ที่ใช้ได้
| เมธอด | Endpoint | คำอธิบาย |
|---|---|---|
| POST | /sub_merchants | สร้าง sub-merchant ใหม่ |
| GET | /sub_merchants/:id | ดึงข้อมูล sub-merchant เฉพาะ |
| GET | /sub_merchants | แสดงรายการ sub-merchants ทั้งหมด |
| PATCH | /sub_merchants/:id | อัปเดตรายละเอียด sub-merchant |
| DELETE | /sub_merchants/:id | ปิดใช้งาน sub-merchant |
| GET | /sub_merchants/search | ค้นหา sub-merchants |
กรณีการใช้งานทั่วไป
แพลตฟอร์มตลาดกลาง
เพิ่มผู้ขายและจัดกา รการประมวลผลการชำระเงิน ค่าคอมมิชชัน และการจ่ายเงิน
ผู้รวมบริการ
จัดการผู้ให้บริการ (คนขับ ผู้รับเหมา ฟรีแลนซ์) ด้วยบัญชีการชำระเงินแยกกัน
ระบบแฟรนไชส์
ตั้งค่าการประมวลผลการชำระเงินสำหรับสาขาแฟรนไชส์ด้วยการจัดการแบบรวมศูนย์
อีคอมเมิร์ซหลายผู้ขาย
เปิดให้ผู้ขายหลายรายขายสินค้าผ่านหน้าร้านเดียวด้วยการชำระเงินแยกกัน
แพลตฟอร์มจองที่พัก
จัดการเจ้าของที่พัก เจ้าของอสังหาริมทรัพย์ หรือผู้ให้บริการด้วยการแบ่งการชำระเงินอัตโนมัติ
แนวทางปฏิบัติที่ดี
- ตรวจสอบข้อมูลธุรกิจ ก่อนสร้าง sub-merchants
- จัดเก็บ sub-merchant IDs ในฐานข้อมูลของคุณเพื่ออ้างอิง
- ดำเนินการ KYC อย่างเหมาะสม เพื่อปฏิบัติตามกฎระเบียบ
- ตรวจสอบกิจกรรม sub-merchant เพื่อป้องกันการฉ้อโกง
- ใช้ metadata สำหรับการจัดหมวดหมู่ที่กำหนดเอง (business_type, region เป็นต้น)
- จัดการการเปลี่ยนแปลงสถานะการตรวจสอบ ผ่าน webhooks
- ทดสอบอย่างละเอียด ในโหมดทดสอบก่อนเปิดใช้งานจริง
- อัปเดตบันทึก เมื่อข้อมูลธุรกิจเปลี่ยนแปลง
รหัสสถานะ Sub-Merchant
| สถานะ | คำอธิบาย |
|---|---|
pending | รอการตรวจสอบและอนุมัติ |
active | ตรวจสอบแล้วและสามารถรับการชำระเงินได้ |
suspended | ถูกปิดใช้งานชั่วคราว |
deactivated | ถูกลบออกอย่างถาวร |
rejected | การตรวจสอบล้มเหลว |
รหัสความล้มเหลว
เมื่อการสร้างหรือการตรวจสอบ sub-merchant ล้มเหลว แอตทริบิวต์ failure_code จะระบุเหตุผล:
| รหัส | ข้อความ | คำอธิบ าย |
|---|---|---|
invalid_business_info | "invalid business information" | ไม่สามารถตรวจสอบรายละเอียดธุรกิจได้ |
document_required | "additional documents required" | ต้องการเอกสารเพิ่มเติมสำหรับการตรวจสอบ |
bank_account_invalid | "invalid bank account" | การตรวจสอบบัญชีธนาคารล้มเหลว |
compliance_failed | "compliance check failed" | ไม่ผ่านข้อกำหนดความสอดคล้อง |
duplicate_merchant | "duplicate merchant" | Sub-merchant มีอยู่แล้ว |
region_not_supported | "region not supported" | ภูมิภาคธุรกิจไม่รองรับ |
ข้อพิจารณาด้านความปลอดภัย
- การเข้ารหัสข้อมูล - ข้อมูลที่ละเอียดอ่อนทั้งหมดถูกเข้ารหัสทั้งขณะจัดเก็บและส่ง
- ความสอดคล้อง KYC - Sub-merchants ต้องผ่านการตรวจสอบต ัวตน
- การตรวจสอบการฉ้อโกง - ธุรกรรมถูกตรวจสอบสำหรับกิจกรรมที่น่าสงสัย
- การควบคุมการเข้าถึง - ใช้การยืนยันตัวตนด้วย secret key
- บันทึกการตรวจสอบ - การเปลี่ยนแปลงทั้งหมดถูกบันทึกเพื่อความสอดคล้อง
แหล่งข้อมูลที่เกี่ยวข้อง
- Charges API - ประมวลผลการชำระเงินสำหรับ sub-merchants
- Transfers API - ส่งการจ่ายเงินไปยัง sub-merchants
- Balance API - ตรวจสอบยอดคงเหลือ
- Webhooks - รับเหตุการณ์ sub-merchant
ต้องการความช่วยเหลือ? ติดต่อ support@omise.co สำหรับการตั้งค่าบัญชีแพลตฟอร์ม การตรวจสอบ sub-merchant หรือความช่วยเหลือในการผสานระบบ