TrueMoney Red Packet API

REST API สำหรับตรวจสอบและแลกรับบัตรกำนัลอั่งเปา (อั่งเปา) ของ TrueMoney รองรับการตรวจสอบสถานะบัตรกำนัลและรับเงินเข้าเบอร์มือถือไทย ผ่านแพลตฟอร์ม TrueMoney Gift โดยตรง

URL หลัก

https://api.truemoney.szdev.xyz

คำนำหน้า Path

/api/v1

โปรโตคอลHTTPS

Content-Type

application/json

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

ไม่จำเป็นต้องยืนยันตัวตน - ทุก endpoint เปิดให้ใช้งานได้สาธารณะโดยไม่ต้องใช้ API Key หรือ Token

Endpoints

GET/api/v1/health

ตรวจสอบสถานะระบบ

ตรวจสอบว่า API พร้อมใช้งานหรือไม่

การตอบกลับ · 200 OK

{
  "success": true,
  "message": "พร้อมใช้งาน"
}

GET/api/v1/voucher/:code

ตรวจสอบบัตรกำนัล

ตรวจสอบสถานะของบัตรกำนัลอั่งเปา TrueMoney ก่อนทำการแลกรับ

พารามิเตอร์ใน Path

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
`code`	string	ใช่	รหัสบัตรกำนัล TrueMoney

การตอบกลับ · 200 OK · พร้อมใช้งาน

{
  "success": true,
  "message": "ตรวจสอบบัตรกำนัลสำเร็จ",
  "data": { ... }
}

การตอบกลับ · 200 OK · ถูกใช้งานแล้ว

{
  "success": false,
  "message": "Voucher already redeemed by 0812345678",
  "data": {
    "redeemer": {
      "mobile": "0812345678",
      "name": "John Doe",
      "amount": 100,
      "date": "2026-06-20T10:30:00.000Z"
    }
  }
}

การตอบกลับเมื่อเกิดข้อผิดพลาด

สถานะ	ข้อความ	สาเหตุ
`400`	รูปแบบรหัสบัตรกำนัลไม่ถูกต้อง	รหัสบัตรกำนัลไม่ถูกรูปแบบ
`500`	ไม่สามารถตรวจสอบบัตรกำนัลได้	ข้อผิดพลาดภายในหรือเครือข่าย

POST/api/v1/redeem

แลกรับบัตรกำนัล

แลกรับบัตรกำนัลอั่งเปา TrueMoney และรับเงินเข้าเบอร์มือถือไทยที่กำหนด

ข้อมูล Request · application/json

ฟิลด์	ประเภท	จำเป็น	คำอธิบาย
`phoneNumber`	string	ใช่	เบอร์มือถือไทย - 0[689]xxxxxxxx
`voucherCode`	string	ใช่	รหัสบัตรกำนัล หรือลิงก์ซองอั่งเปาเต็ม

ตัวอย่าง Request · แบบรหัสบัตรกำนัล

POST /api/v1/redeem
Content-Type: application/json

{
  "phoneNumber": "0812345678",
  "voucherCode": "ABC123XYZ456"
}

ตัวอย่าง Request · แบบลิงก์ซองอั่งเปาเต็ม

POST /api/v1/redeem
Content-Type: application/json

{
  "phoneNumber": "0812345678",
  "voucherCode": "https://gift.truemoney.com/campaign/?v=ABC123XYZ456"
}

การตอบกลับ · 200 OK · สำเร็จ

{
  "success": true,
  "message": "แลกรับบัตรกำนัลสำเร็จ",
  "data": {
    "amount": "100.00",
    "phone": "0812345678",
    "owner_profile": "นาย เจ้าของ ซอง",
    "redeemer_profile": "นาย ผู้รับ เงิน",
    "time": "2024-03-20 14:30:00"
  }
}

การตอบกลับเมื่อเกิดข้อผิดพลาด

สถานะ	ข้อความ	สาเหตุ
`400`	Invalid Thai Phone Number	เบอร์โทรไม่ถูกรูปแบบมือถือไทย
`400`	รูปแบบข้อมูลไม่ถูกต้อง	ไม่ส่ง phoneNumber หรือ voucherCode
`400`	ซองถูกรับไปหมดแล้ว / ซองหมดอายุ / ไม่พบซอง	ข้อความจาก TrueMoney โดยตรง

การแลกรับที่สำเร็จจะถูก cache ไว้ 5 นาที - หากส่ง request ซ้ำด้วยเบอร์โทรและรหัสเดิมในช่วงเวลานี้ จะได้ผลลัพธ์จาก cache โดยไม่เรียก TrueMoney ซ้ำ การตอบกลับเมื่อเกิดข้อผิดพลาดจะถูก cache ไว้ 1 นาที

รูปแบบการตอบกลับ

ทุก response มีโครงสร้าง JSON เดียวกัน

interface ApiResponse<T = any> {
  success: boolean  // true เมื่อสำเร็จ, false เมื่อล้มเหลวเชิงธุรกิจ
  message: string   // ข้อความสถานะ (ภาษาไทย)
  data?: T          // ข้อมูลเพิ่มเติม - มีเฉพาะบาง response
}

ฟิลด์	ประเภท	มีเสมอ	คำอธิบาย
`success`	boolean	ใช่	บ่งบอกผลลัพธ์การทำงาน
`message`	string	ใช่	ข้อความสถานะเป็นภาษาไทย
`data`	object	ไม่เสมอ	ข้อมูลเพิ่มเติม - มีเฉพาะบาง response

success: false ไม่ได้หมายความว่า HTTP error เสมอไป เช่น กรณีบัตรถูกใช้งานแล้ว จะได้ HTTP 200 แต่ success: false

รูปแบบเบอร์โทรศัพท์

ฟิลด์ phoneNumber ต้องเป็นเบอร์มือถือไทยที่ถูกต้องเท่านั้น

Regex^(?:0)[689]\d{8}$

ความยาว10 หลัก

คำนำหน้า

06x08x09x

ตัวอย่าง

0812345678

0987654321

0678901234