ฝากเงินด้วยสลิป

ใช้งานได้

POST/api/v1/deposits/slip

ส่งสลิปโอนเงินของสมาชิกให้ระบบตรวจสอบ

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

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
account_id	string (uuid)	—	id บัญชีปลายทางที่สมาชิกโอนเข้า (จากช่องทางฝากเงิน method SLIP) — แนะนำให้ส่งเพื่อช่วยจับคู่รายการ
slip_base64	string (base64)	ใช่	รูปสลิปเข้ารหัส base64 (ไม่ใส่ data: prefix) — ไฟล์ต้นทางไม่เกิน 12MB
content_type	string	ใช่	MIME type ของรูป ต้องเป็น image/* เช่น image/jpeg, image/png

ตัวอย่าง request

{
  "account_id": "7c2f9d4e-8b1a-4f6c-9e3d-a5b7c9d1e2f3",
  "slip_base64": "/9j/4AAQSkZJRgABAQAAAQABAAD…",
  "content_type": "image/jpeg"
}

Response

ฟิลด์ใน data

ฟิลด์	ชนิด	จำเป็น	คำอธิบาย
order_id	string (uuid)	—	id รายการฝากที่สร้างขึ้น
amount	number	—	ยอดฝากที่ตรวจได้จากสลิป (บาท) — เครดิตเข้ากระเป๋าแล้ว

ตัวอย่าง response

{
  "success": true,
  "code": 0,
  "message": "สำเร็จ",
  "data": {
    "order_id": "e4d8b2a6-9c1f-4e3b-a7d5-0f2c4a6e8b1d",
    "amount": 500
  },
  "request_uuid": "9f2b7d1e-4a83-4c1f-b2ce-6d5a0e8f3c21"
}

Error codes ที่พบได้

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