ภาพรวม

Agent API สำหรับสร้างรายการถอน รายการฝาก ติดตามสถานะ และจัดการบัญชีต้นทาง เมื่อรายการสิ้นสุดหรือฝากจับคู่ได้ ระบบจะส่ง Callback ไปยัง URL ที่กำหนดไว้

BASE URL

API Server

Production

https://api.gringotts-th.com/

GUIDANCE

ทุก Endpoint ใช้ Base URL เดียวกันและขึ้นต้นด้วย /api/v1

เส้นทาง /integration แยกจาก Back Office โดยสมบูรณ์ จึงใช้ Session ของหน้าเว็บหรือคีย์ที่ขึ้นต้นด้วย gak_ ไม่ได้

จำนวนเงินใช้หน่วยบาทและต้องเป็น JSON number รองรับทศนิยมไม่เกิน 2 ตำแหน่ง เช่น 1250.50

วันและเวลาใน Response ใช้มาตรฐาน ISO 8601 และเขตเวลา UTC

ใช้ Device token ที่ขึ้นต้นด้วย gdt_ จากหน้าอุปกรณ์ บัญชีต้นทางจะอ้างอิงจากบัญชีที่ผูกกับ Device token นี้

คำขอแบบ POST และ PATCH ต้องส่ง Signature ใน Payload โดยใช้ Device token เป็น HMAC key ส่วน GET ใช้เฉพาะ Authorization header

หากร้องขอรายการหรือบัญชีที่ไม่ได้ผูกกับอุปกรณ์ ระบบจะตอบ Error code NOT_FOUND

Agent API ไม่มี Endpoint สำหรับตั้ง PIN ยกเลิกรายการ ขอรูปสลิป สั่งงานอุปกรณ์ หรือเลือก Module

EXAMPLE

RESPONSE

{
  "error": {
    "code": "LIMIT_EXCEEDED",
    "message": "เกินเพดาน",
    "details": { "field": "amount" }
  }
}