วิธีการใช้ TrueMoney Voucher API

ney Voucher API ช่วยให้คุณสามารถตรวจสอบและแลกรับเงินผ่านลิงก์อั่งเปาได้โดยอัตโนมัติ ในบทความนี้จะอธิบายวิธีการใช้งาน API อย่างละเอียด

ส่วนประกอบหลักของ API

TrueMoney Voucher API มี 2 ส่วนหลัก:

1. API ตรวจสอบ (Verify) - ใช้ตรวจสอบสถานะอั่งเปา
2. API แลกรับ (Redeem) - ใช้แลกรับเงินจากอั่งเปา

วิธีการตรวจสอบอั่งเปา (Verify)

Endpoint

GET https://gift.truemoney.com/campaign/vouchers/{REF}/verify

โดย {REF} คือรหัสอ้างอิงของอั่งเปาที่ได้จากลิงก์แชร์

ตัวอย่างการตอบกลับ

json
{
  "status": {
    "message": "success",
    "code": "SUCCESS"
  },
  "data": {
    "voucher": {
      "voucher_id": "******",
      "amount_baht": "10.00",
      "redeemed_amount_baht": "0.00",
      "member": 1,
      "status": "active",
      "link": "******",
      "detail": "",
      "expire_date": 1740264688576,
      "type": "R",
      "redeemed": 0,
      "available": 1
    },
    "owner_profile": {
      "full_name": "****** ***"
    },
    "redeemer_profile": null,
    "my_ticket": null,
    "tickets": []
  }
}

ข้อมูลสำคัญที่ได้รับ

• amount_baht - จำนวนเงินในอั่งเปา (บาท)
• status - สถานะของอั่งเปา (active, expired, เป็นต้น)
• available - จำนวนที่สามารถแลกรับได้ (1 = รับได้, 0 = รับไม่ได้)
• redeemed - สถานะการรับแล้ว (0 = ยังไม่ได้รับ, 1 = รับแล้ว)
• expire_date - วันหมดอายุ (เป็น timestamp)

วิธีการแลกรับอั่งเปา (Redeem)

Endpoint

POST https://gift.truemoney.com/campaign/vouchers/{REF}/redeem

ข้อมูลที่ต้องส่ง (JSON)

json
{
  "mobile": "เบอร์ผู้รับ",
  "voucher_hash": "{REF}"
}

โดย:

• mobile - เบอร์โทรศัพท์ที่จะรับเงิน
• voucher_hash - รหัสอ้างอิงของอั่งเปา (เหมือนกับที่ใช้ในการตรวจสอบ)

ตัวอย่างการตอบกลับเมื่อแลกรับสำเร็จ

json
{
  "status": {
    "message": "success",
    "code": "SUCCESS"
  },
  "data": {
    "voucher": {
      "voucher_id": "******",
      "amount_baht": "10.00",
      "redeemed_amount_baht": "10.00",
      "member": 1,
      "status": "active",
      "link": "******",
      "detail": "",
      "expire_date": 1740264688576,
      "type": "R",
      "redeemed": 1,
      "available": 0
    },
    "owner_profile": {
      "full_name": "****** ***"
    },
    "redeemer_profile": {
      "mobile_number": "******"
    },
    "my_ticket": {
      "mobile": "******",
      "update_date": 1740261281628,
      "amount_baht": "10.00",
      "full_name": "****** ***",
      "profile_pic": null
    },
    "tickets": [
      {
        "mobile": "061-xxx-******",
        "update_date": 1740261281628,
        "amount_baht": "10.00",
        "full_name": "****** ***",
        "profile_pic": "https://profile-images-cdn.truemoney.com/******.jpg"
      }
    ]
  }
}

วิธีการใช้งานทั้งหมดในการพัฒนา

ตัวอย่างการใช้งานใน JavaScript

javascript
// ตัวอย่างการใช้ TrueMoney Voucher API ด้วย JavaScript
async function verifyTrueMoneyVoucher(voucherCode) {
  try {
    const response = await fetch(`https://gift.truemoney.com/campaign/vouchers/${voucherCode}/verify`, {
      method: 'GET',
      headers: {
        'Content-Type': 'application/json'
      }
    });
    
    const data = await response.json();
    
    if (data.status.code === 'SUCCESS') {
      console.log('ตรวจสอบอั่งเปาสำเร็จ');
      console.log(`จำนวนเงิน: ${data.data.voucher.amount_baht} บาท`);
      console.log(`สถานะ: ${data.data.voucher.status}`);
      console.log(`สามารถรับได้: ${data.data.voucher.available === 1 ? 'ได้' : 'ไม่ได้'}`);
      
      // คืนค่าข้อมูลอั่งเปา
      return data.data;
    } else {
      console.error('เกิดข้อผิดพลาด:', data.status.message);
      return null;
    }
  } catch (error) {
    console.error('เกิดข้อผิดพลาดในการเชื่อมต่อ:', error);
    return null;
  }
}

async function redeemTrueMoneyVoucher(voucherCode, mobileNumber) {
  try {
    const response = await fetch(`https://gift.truemoney.com/campaign/vouchers/${voucherCode}/redeem`, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        mobile: mobileNumber,
        voucher_hash: voucherCode
      })
    });
    
    const data = await response.json();
    
    if (data.status.code === 'SUCCESS') {
      console.log('แลกรับอั่งเปาสำเร็จ');
      console.log(`จำนวนเงินที่ได้รับ: ${data.data.voucher.redeemed_amount_baht} บาท`);
      console.log(`เข้าบัญชีเบอร์: ${data.data.redeemer_profile.mobile_number}`);
      
      // คืนค่าข้อมูลหลังแลกรับ
      return data.data;
    } else {
      console.error('เกิดข้อผิดพลาด:', data.status.message);
      return null;
    }
  } catch (error) {
    console.error('เกิดข้อผิดพลาดในการเชื่อมต่อ:', error);
    return null;
  }
}

// วิธีการใช้งาน
async function main() {
  // รหัสอั่งเปาที่ได้จากลิงก์แชร์
  const voucherCode = '******';
  
  // ตรวจสอบอั่งเปาก่อน
  const voucherInfo = await verifyTrueMoneyVoucher(voucherCode);
  
  if (voucherInfo && voucherInfo.voucher.available === 1) {
    // ถ้าอั่งเปายังรับได้ ทำการแลกรับ
    const mobileNumber = '0612345678'; // เบอร์โทรที่จะรับเงิน
    const redeemedInfo = await redeemTrueMoneyVoucher(voucherCode, mobileNumber);
    
    if (redeemedInfo) {
      console.log('แลกรับเงินสำเร็จ!');
    }
  } else {
    console.log('อั่งเปาไม่สามารถแลกรับได้');
  }
}

// เรียกใช้งาน
main();

ตัวอย่างการใช้งานใน PHP

php
<?php
// ตัวอย่างการใช้ TrueMoney Voucher API ด้วย PHP

/**
 * ฟังก์ชันสำหรับตรวจสอบสถานะอั่งเปา
 * 
 * @param string $voucherCode รหัสอั่งเปา
 * @return array|null ข้อมูลอั่งเปา หรือ null หากมีข้อผิดพลาด
 */
function verifyTrueMoneyVoucher($voucherCode) {
    $url = "https://gift.truemoney.com/campaign/vouchers/{$voucherCode}/verify";
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HEADER, false);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($httpCode == 200) {
        $data = json_decode($response, true);
        
        if ($data['status']['code'] === 'SUCCESS') {
            echo "ตรวจสอบอั่งเปาสำเร็จ\n";
            echo "จำนวนเงิน: " . $data['data']['voucher']['amount_baht'] . " บาท\n";
            echo "สถานะ: " . $data['data']['voucher']['status'] . "\n";
            echo "สามารถรับได้: " . ($data['data']['voucher']['available'] == 1 ? 'ได้' : 'ไม่ได้') . "\n";
            
            return $data['data'];
        } else {
            echo "เกิดข้อผิดพลาด: " . $data['status']['message'] . "\n";
            return null;
        }
    } else {
        echo "เกิดข้อผิดพลาดในการเชื่อมต่อ: HTTP Code " . $httpCode . "\n";
        return null;
    }
}

/**
 * ฟังก์ชันสำหรับแลกรับอั่งเปา
 * 
 * @param string $voucherCode รหัสอั่งเปา
 * @param string $mobileNumber เบอร์โทรศัพท์ที่จะรับเงิน
 * @return array|null ข้อมูลหลังแลกรับ หรือ null หากมีข้อผิดพลาด
 */
function redeemTrueMoneyVoucher($voucherCode, $mobileNumber) {
    $url = "https://gift.truemoney.com/campaign/vouchers/{$voucherCode}/redeem";
    
    $data = [
        'mobile' => $mobileNumber,
        'voucher_hash' => $voucherCode
    ];
    
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json'
    ]);
    
    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    
    if ($httpCode == 200) {
        $data = json_decode($response, true);
        
        if ($data['status']['code'] === 'SUCCESS') {
            echo "แลกรับอั่งเปาสำเร็จ\n";
            echo "จำนวนเงินที่ได้รับ: " . $data['data']['voucher']['redeemed_amount_baht'] . " บาท\n";
            echo "เข้าบัญชีเบอร์: " . $data['data']['redeemer_profile']['mobile_number'] . "\n";
            
            return $data['data'];
        } else {
            echo "เกิดข้อผิดพลาด: " . $data['status']['message'] . "\n";
            return null;
        }
    } else {
        echo "เกิดข้อผิดพลาดในการเชื่อมต่อ: HTTP Code " . $httpCode . "\n";
        return null;
    }
}

// ตัวอย่างการใช้งาน
$voucherCode = '******'; // รหัสอั่งเปาที่ได้จากลิงก์แชร์

// ตรวจสอบอั่งเปาก่อน
$voucherInfo = verifyTrueMoneyVoucher($voucherCode);

if ($voucherInfo && $voucherInfo['voucher']['available'] == 1) {
    // ถ้าอั่งเปายังรับได้ ทำการแลกรับ
    $mobileNumber = '0612345678'; // เบอร์โทรที่จะรับเงิน
    $redeemedInfo = redeemTrueMoneyVoucher($voucherCode, $mobileNumber);
    
    if ($redeemedInfo) {
        echo "แลกรับเงินสำเร็จ!\n";
    }
} else {
    echo "อั่งเปาไม่สามารถแลกรับได้\n";
}

การใช้งานตามขั้นตอน

1. การดึงรหัสอั่งเปาจากลิงก์

   • เมื่อได้รับลิงก์อั่งเปา (เช่น https://gift.truemoney.com/campaign/?v=XXXXXXXXXXXX) ให้ดึงรหัส XXXXXXXXXXXX ออกมา

2. ตรวจสอบสถานะอั่งเปา

   • ส่งคำขอ GET ไปที่ Verify API เพื่อตรวจสอบว่าอั่งเปายังใช้ได้หรือไม่
   • ตรวจสอบค่า available ว่าเป็น 1 หรือไม่ (1 = รับได้, 0 = รับไม่ได้)

3. แลกรับอั่งเปา

   • ถ้าอั่งเปายังรับได้ ส่งคำขอ POST ไปที่ Redeem API พร้อมเบอร์โทรศัพท์
   • ตรวจสอบการตอบกลับเพื่อยืนยันว่าแลกรับสำเร็จ

ข้อควรระวัง

1. การหมดอายุ - อั่งเปาจะมีวันหมดอายุตาม expire_date ควรตรวจสอบทุกครั้ง
2. การรับซ้ำ - อั่งเปาที่รับไปแล้ว (redeemed = 1) จะไม่สามารถรับได้อีก
3. เบอร์โทรศัพท์ - ต้องเป็นเบอร์โทรศัพท์ที่ลงทะเบียนกับ TrueMoney Wallet

สรุป

TrueMoney Voucher API ช่วยให้สามารถตรวจสอบและแลกรับอั่งเปาได้โดยอัตโนมัติ ซึ่งสามารถนำไปประยุกต์ใช้ในหลายรูปแบบ เช่น:

• ระบบรับชำระเงินผ่านอั่งเปา
• ระบบสำหรับตรวจสอบและแลกรับอั่งเปาอัตโนมัติ
• แอปพลิเคชันสำหรับจัดการอั่งเปาจำนวนมาก

ตัวอย่างโค้ดที่แสดงไว้สามารถนำไปปรับใช้เพื่อพัฒนาระบบที่เกี่ยวข้องกับ TrueMoney Voucher ได้ตามต้องการ