ฝากเงินผ่านเกตเวย์ (QR)

ใช้งานได้

POST/api/v1/deposits/gateway

สร้างรายการฝากผ่าน payment gateway

แสดง QR ให้สมาชิกสแกนก่อน expires_at — เมื่อชำระสำเร็จ เงินเข้ากระเป๋าอัตโนมัติ (ตรวจยอดใหม่ได้จาก endpoint ยอดคงเหลือ/ประวัติธุรกรรม) ไม่ต้องยืนยันซ้ำผ่าน API นี้

Headers

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
Authorization	string	ใช่	ใช้ — แนบ Bearer <access_token> ของสมาชิก
X-Api-Key	string	ใช่	API key ของ agent (ak_…) จากหน้า bo
X-Timestamp	string	ใช่	เวลา sign เป็น unix milliseconds (คลาดเคลื่อนได้ ±300 วินาที)
X-Nonce	string	ใช่	ค่าไม่ซ้ำต่อ request (UUIDv4) กัน replay
X-Signature	string	ใช่	hex(HMAC-SHA256(secret, canonical)) — ดูหน้า Authentication
X-Player-IP	string	—	IP จริงของผู้เล่น (IPv4/IPv6) — แนะนำให้ส่ง (ใช้ใน login history)
X-Player-UA	string	—	User-Agent ของผู้เล่น (optional — ลง login history)
X-Request-Id	string	—	correlation id ของฝั่งคุณ — ระบบ echo กลับใน request_uuid (แนะนำให้ส่ง)
x-lang	string	—	th (default) หรือ en — ภาษาของ message

Request bodyapplication/json

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
amount	number	ใช่	ยอดฝาก (บาท)

ตัวอย่าง request

{
  "amount": 500
}

Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
order_id	string (uuid)	—	id รายการฝากที่สร้างขึ้น
qrcode	string \| null	—	payload ของ QR (PromptPay string) สำหรับ render เป็นภาพ QR ให้สมาชิกสแกน — null ถ้าเกตเวย์ไม่ออก QR
expires_at	string (ISO 8601)	—	เวลาหมดอายุของ QR

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "order_id": "a1c3e5b7-2d4f-4a6c-8e0b-9d1f3a5c7e9b",
    "qrcode": "00020101021229370016A000000677010111011300668123456785802TH53037645406500.006304ABCD",
    "expires_at": "2026-07-05T12:30:00.000Z"
  },
  "request_uuid": "9f2b7d1e-4a83-4c1f-b2ce-6d5a0e8f3c21"
}

Error codes ที่พบได้

code	ชื่อ	HTTP	ข้อความ
1002	FORBIDDEN	403	ไม่มีสิทธิ์เข้าถึงสมาชิกอยู่ใต้ agent โหมด SEAMLESS — กระเป๋าเงินอยู่ฝั่ง agent จึงฝากผ่าน member API ไม่ได้
4001	VALIDATION_ERROR	400	ข้อมูลไม่ถูกต้องamount ไม่ถูกต้อง เช่น ไม่ส่งมา เป็น 0/ติดลบ หรืออยู่นอกช่วงที่ช่องทางรับ
4002	BAD_REQUEST	400	คำขอไม่ถูกต้องระบุ agent ของ request ไม่ได้ (ไม่รู้จักโดเมน/credential)
5005	GATEWAY_TEMP_UNAVAILABLE	503	ช่องทางชำระเงินไม่พร้อมใช้งานชั่วคราวเกตเวย์ปลายทางขัดข้องชั่วคราว — ลองใหม่ หรือให้สมาชิกใช้ช่องทางอื่น
5007	GATEWAY_NOT_CONFIGURED	422	ยังไม่ได้ตั้งค่าช่องทางชำระเงินไซต์ของคุณยังไม่ได้ตั้งค่าช่องทางเกตเวย์สำหรับฝากเงิน
9002	SERVICE_UNAVAILABLE	503	บริการไม่พร้อมใช้งานระบบชำระเงินภายในไม่ตอบสนองชั่วคราว — ลองใหม่ภายหลัง