Linked Accounts API
Linked Accounts API ช่วยให้คุณจัดการ sub-accounts ที่เชื่อมต่อสำหรับแพลตฟอร์มของคุณ Linked accounts แสดงถึงร้านค้า ผู้ขาย หรือผู้ให้บริการที่ประมวลผลการชำระเงินผ่านแพลตฟอร์มของคุณ
ภาพรวม
Linked accounts ช่วยให้คุณ:
- เชื่อมต่อบัญชีร้านค้า เข้ากับแพลตฟอร์มของคุณเพื่อประมวลผลการชำระเงิน
- จัดการ sub-accounts สำหรับผู้ขายในตลาดออนไลน์และผู้ให้บริการ
- แบ่งการชำระเงิน ระหว่างแพลตฟอร์มและ linked accounts
- ติดตามสถานะบัญชี และสถานะการยืนยัน
- ค้นหาและกรอง linked accounts ด้วยเกณฑ์ต่างๆ
ประเภทของ Linked Account
บัญชีบุคคล
บัญชีส่วนบุคคลสำหรับร้านค้าหรือผู้ให้บริการรายบุคคล ประกอบด้วย:
- ชื่อ-นามสกุลและข้อมูลติดต่อ
- รายละเอียดบัญชีธนาคารสำหรับการจ่ายเงิน
- สถานะการยืนยัน
บัญชีธุรกิจ
บัญชีบริษัทหรือธุรกิจ ประกอบด้วย:
- ชื่อบริษัทและรายละเอียดการจดทะเบียน
- เลขประจำตัวผู้เสียภาษี
- รายละเอียดบัญชีธนาคารสำหรับการจ่ายเงิน
- สถานะการยืนยัน
วงจรชีวิตของ Linked Account
- เชื่อมต่อ - ร้านค้าเชื่อมต่อบัญชีกับแพลตฟอร์มของคุณ
- ยืนยัน - บัญชีผ่านการยืนยัน (อัตโนมัติหรือด้วยตนเอง)
- เปิด ใช้งาน - บัญชีสามารถประมวลผลการชำระเงินและรับเงินได้
- ระงับ - บัญชีถูกปิดใช้งานชั่วคราว (สามารถเปิดใช้งานอีกครั้งได้)
- ยกเลิกการเชื่อมต่อ - บัญชีถูกลบออกจากแพลตฟอร์ม
สถานะบัญชี
Linked accounts มีค่าสถานะดังนี้:
| สถานะ | คำอธิบาย |
|---|---|
pending | สร้างบัญชีแล้ว กำลังดำเนินการลงทะเบียน |
successful | ลงทะเบียนสำเร็จ |
failed | ลงทะเบียนล้มเหลว (ตรวจสอบ failure_code และ failure_message) |
expired | ลิงก์ลงทะเบียนหมดอายุก่อนดำเนินการเสร็จสิ้น |
deleted | บัญชีถูกลบแล้ว |
ความสามารถของบัญชี
แต่ละ linked account อาจมีความสามารถที่เปิดใช้งานแตกต่างกัน:
| ความสามารถ | คำอธิบาย |
|---|---|
card_payments | รับชำระเงินด้วยบัตรได้ |
transfers | รับเงินได้ |
refunds | ประมวลผลการคืนเงินได้ |
การยืนยันตัวตน
Endpoints ของ linked account ทั้งหมดต้องใช้ secret key สำหรับการยืนยันตัวตน อย่าเปิดเผย secret key ของคุณในโค้ดฝั่งไคลเอนต์
Endpoints ที่ใช้ได้
| เมธอด | Endpoint | คำอธิบาย |
|---|---|---|
| POST | /linked_accounts | สร้าง linked account ใหม่ |
| GET | /linked_accounts | แสดงรายการ linked accounts ทั้งหมด |
| GET | /linked_accounts/:id | ดึง linked account เฉพาะ |
| GET | /linked_accounts/search | ค้นหา linked accounts |
| DELETE | /linked_accounts/:id | ลบ linked account |
กรณีการใช้งานทั่วไป
แพลตฟอร์มตลาดออนไลน์
เชื่อมต่อบัญชีผู้ขายเพื่อประมวลผลการชำระเงินและแจกจ่ายรายได้โดยอัตโนมัติ
แพลตฟอร์ม SaaS
จัดการบัญชีร้านค้าสำหรับธุรกิจที่ใช้แพลตฟอร์มซอฟต์แวร์ของคุณ
บริการรวม
เตรียมความพร้อมและจัดการผู้ให้บริการหลายรายภายใต้แพลตฟอร์มของคุณ
เครือข่ายแฟรนไชส์
เชื่อมต่อและจัดการการชำระเงินสำหรับสาขาแฟรนไชส์
แนวทางปฏิบัติที่ดี
- ยืนยันบัญชีทันทีหลังการเชื่อมต่อ
- เก็บ linked account IDs ในฐานข้อมูลของคุณ
- ตรวจสอบการเปลี่ยนแปลงสถานะบัญชี
- จัดการความล้มเหลวในการยืนยันอย่างเหมาะสม
- ใช้ metadata สำหรับก ารจัดหมวดหมู่ (merchant_type, region ฯลฯ)
- ใช้งาน webhooks เพื่อรับการอัปเดตสถานะบัญชี
- ตรวจสอบกิจกรรมบัญชีเป็นประจำ เพื่อการปฏิบัติตามข้อกำหนด
ข้อพิจารณาด้านความปลอดภัย
- การควบคุมการเข้าถึง - ใช้การยืนยันตัวตนด้วย secret key
- การเข้ารหัสข้อมูล - ข้อมูลที่ละเอียดอ่อนถูกเข้ารหัสเมื่อจัดเก็บ
- บันทึกการตรวจสอบ - ติดตามการเปลี่ยนแปลงบัญชีทั้งหมด
- การปฏิบัติตามข้อกำหนด - บัญชีผ่านการยืนยัน KYC
- การป้องกันการฉ้อโกง - ตรวจสอบกิจกรรมที่น่าสงสัย
แหล่งข้อมูลที่เกี่ยวข้อง
- Transfers API - ส่งเงินไปยัง linked accounts
- Charges API - ประมวลผลการชำระเงินสำหรับ linked accounts
- Balance API - ตรวจสอบยอดคงเหลือบัญชี
- Webhooks - รับ events สถานะบัญชี
ต้องการความช่วยเหลือ? ติดต่อ support@omise.co สำหรับการตั้งค่า linked account การยืนยัน หรือความช่วยเหลือในการเชื่อมต่อ