การยืนยันตัวตน

ใช้ APIKEY ของคุณ (ดูได้ที่แดชบอร์ด → เมนู "แพ็คเกจ / APIKEY" — ต้องเช่าแพ็คเกจก่อน; คีย์ใน "คีย์ของฉัน" ใช้ได้แค่ /api/v1/ping) ส่งมา 1 ใน 3 วิธี:

Header: X-API-Key: <คีย์>
Query: ?api_key=<คีย์>
Body: { "api_key": "<คีย์>" }

คีย์ที่เช่าจากแพ็คเกจมีวันหมดอายุและโควตาการใช้งาน (จำนวนครั้ง / จำนวนโอน) — ดูสถานะได้ที่แดชบอร์ด

บัญชีที่ผูกกับคีย์

ถ้าคีย์ถูก "ผูกบัญชี" ไว้ ระบบจะใช้ accountid / cardid / สกุลเงิน ของบัญชีนั้นเป็นค่าเริ่มต้นอัตโนมัติตอนโอนเงิน (ไม่ต้องส่ง sourceAccountId มาเอง) — ถ้าส่งมาเองจะทับค่าที่ผูกไว้

ก่อนเรียก API ต้องมีอะไรบ้าง
  1. สมัครสมาชิกและเช่าแพ็คเกจที่ยังไม่หมดอายุ
  2. ใช้ APIKEY จากแพ็คเกจใน header X-API-Key
  3. ผูกบัญชี BCEL กับ APIKEY หรือส่งรหัสบัญชีใน request เอง
  4. สำหรับ session/data ต้องมีข้อมูล login BCEL ของบัญชีที่ผูกไว้
  5. สำหรับโอนเงิน ต้องตรวจบัญชีปลายทางก่อน และต้องมีการยืนยันใบหน้าจากธนาคาร

เส้น API

ตัวอย่างโอนเงิน
ถ้าคีย์ผูกบัญชีต้นทางไว้แล้ว ไม่ต้องส่ง sourceAccountId และ cardId
POST /api/v1/transfer
X-API-Key: bk_xxxxxxxxx
Content-Type: application/json

{
  "destinationAccountId": "010123456789",
  "bank": "BCEL",
  "network": "BCEL",
  "amount": 50000,
  "ccy": "LAK",
  "ticket": "ticket-from-enquiry",
  "desc": "ค่าสินค้า"
}
ระบบจะตรวจอายุคีย์ โควตา session บัญชี และ face token ก่อนส่งคำสั่งเงินจริง
รูปแบบคำตอบ
{"ok": true, ...} // สำเร็จ
{"ok": false, "error": "ข้อความ"}

รหัสสถานะ: 200 สำเร็จ • 400 ข้อมูลไม่ครบ • 401 คีย์ผิด • 403 ถูกระงับ / โควตาหมด / แพ็คเกจหมดอายุ • 503 ระบบยังไม่พร้อม