TrueMoney Voucher API | Official Documentation

ภาพรวม API

TrueMoney Voucher API เป็น RESTful API ที่ช่วยให้คุณสามารถแลกซองอั่งเปา TrueMoney ได้โดยอัตโนมัติ เพียงส่งเบอร์โทรศัพท์และลิงก์ซอง ระบบจะทำการตรวจสอบและแลกเงินเข้า TrueWallet ทันที

คุณสมบัติเด่น

รองรับลิงก์ซองแบบเต็ม URL หรือรหัส 18 ตัว
ตรวจสอบสถานะซองแบบ Real-time
รองรับ CORS สำหรับเรียกใช้จากเว็บไซต์
ข้อความแจ้งเตือนภาษาไทยเข้าใจง่าย
ไม่ต้องใช้ API Key หรือ Token

Rate Limit: สูงสุด 100 requests/minute ต่อ IP

โครงสร้าง Request

Headers

Header	Value	จำเป็น
`Content-Type`	`application/json`	จำเป็น
`Accept`	`application/json`	แนะนำ

Body Parameters

Parameter	Type	คำอธิบาย	จำเป็น
`phone`	string	เบอร์โทร TrueWallet (10 หลัก เช่น 0612345678)	จำเป็น
`voucher`	string	ลิงก์ซองอั่งเปาหรือรหัส 18-120 ตัว	จำเป็น

ตัวอย่าง Request

JSON

{
  "phone": "0661234567",
  "voucher": "https://gift.truemoney.com/campaign/?v=ABC123DEF456GHI789"
}

โครงสร้าง Response

Success Response (HTTP 200)

{
  "success": true,
  "message": "รับเงินสำเร็จ",
  "amount": 50.00,
  "owner": "สมชาย ใจดี",
  "phone": "0661234567",
  "code": "ABC123DEF456GHI789"
}

Error Response

{
  "success": false,
  "message": "ซองหมดแล้ว",
  "code": "ABC123DEF456GHI789"
}

ตัวอย่างโค้ด

JavaScript (Fetch API)

const redeemVoucher = async (phone, voucher) => {
  try {
    const response = await fetch('https://9nine.space/api/', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Accept': 'application/json'
      },
      body: JSON.stringify({ phone, voucher })
    });
    
    const data = await response.json();
    console.log(data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
};

// ใช้งาน
redeemVoucher('0661234567', 'https://gift.truemoney.com/campaign/?v=...');

PHP (cURL)

<?php
$url = 'https://9nine.space/api/';
$data = [
    'phone' => '0661234567',
    'voucher' => 'https://gift.truemoney.com/campaign/?v=...'
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Accept: application/json'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response, true);
curl_close($ch);

print_r($result);
?>

Python (Requests)

import requests
import json

url = 'https://9nine.space/api/'
payload = {
    'phone': '0661234567',
    'voucher': 'https://gift.truemoney.com/campaign/?v=...'
}

headers = {
    'Content-Type': 'application/json',
    'Accept': 'application/json'
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

print(json.dumps(data, indent=2, ensure_ascii=False))

cURL Command

curl -X POST 'https://9nine.space/api/' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "phone": "0661234567",
    "voucher": "https://gift.truemoney.com/campaign/?v=..."
  }'

รหัสข้อผิดพลาด

200

✅ Success

การทำงานสำเร็จ เงินเข้า Wallet แล้ว

400

❌ Bad Request

ข้อมูลไม่ครบถ้วน หรือรูปแบบไม่ถูกต้อง

404

⚠️ Not Found

ไม่พบซองอั่งเปา หรือซองหมดอายุ

500

💥 Server Error

เกิดข้อผิดพลาดที่เซิร์ฟเวอร์

ข้อความ Error (ภาษาไทย)

ข้อความ	สาเหตุ
`ซองหมดแล้ว`	ซองอั่งเปาหมดจำนวน
`ซองถูกรับไปครบแล้ว`	มีคนรับซองครบตามจำนวนที่กำหนด
`ซองนี้ถูกรับไปแล้ว`	ซองนี้เคยถูกรับไปแล้ว
`ไม่พบซอง`	ไม่พบซองอั่งเปาในระบบ
`ซองหมดอายุ`	ซองอั่งเปาหมดอายุการใช้งาน
`เบอร์โทรไม่ถูกต้อง`	รูปแบบเบอร์โทรไม่ถูกต้อง

ทดสอบ API

ทดสอบเรียก API จริงจากหน้าเว็บนี้ กรอกข้อมูลด้านล่าง: