@prakrit_m/tmn-voucher
Version:
ไลบรารี TypeScript สำหรับการแลกคูปองอั่งเปา TrueMoney Wallet
230 lines (185 loc) • 9.57 kB
Markdown
ไลบรารี TypeScript สำหรับการแลกคูปองอั่งเปา TrueMoney Wallet
เติมเงิน Truewallet ด้วยซองอั่งเปา
[](https://www.npmjs.org/package/@prakrit_m/tmn-voucher)
[](https://www.npmjs.org/package/@prakrit_m/tmn-voucher)
[](https://opensource.org/licenses/ISC)
- ใช้งานง่ายและครอบคลุมฟีเจอร์ที่จำเป็น
- รองรับ TypeScript
- สามารถแลกคูปองได้เมื่อตรงตามเงื่อนไขที่กำหนด
- มีการตรวจสอบและ validate ข้อมูลก่อนการแลกคูปอง
- จัดการและแยกประเภท Error Code ได่ง่าย
ติดตั้งแพ็กเกจ:
```bash
npm install @prakrit_m/tmn-voucher
yarn add @prakrit_m/tmn-voucher
pnpm add @prakrit_m/tmn-voucher
```
นำเข้าฟังก์ชัน `redeemvouchers` และใช้มันเพื่อแลกคูปองซองอั่งเปา TrueMoney Wallet
```typescript
import redeemvouchers from "@prakrit_m/tmn-voucher";
// ตัวอย่างข้อมูลสำหรับแลกคูปอง
const phoneNumber = "0812345678";
const voucherUrl = "https://gift.truemoney.com/campaign/?v=YOUR_VOUCHER_CODE";
// ตัวเลือกเพิ่มเติมจะระบุหรือไม่ก็ได้ เช่น จำนวนเงิน
const options = {
amount: 10000, // จำนวนเงินในหน่วยสตางค์ (100 บาท) กรณีที่ยอดเงินไม่ตรงจะไม่ทำการ redeem
};
// ใช้ Promises
function redeemWithPromise() {
redeemvouchers(phoneNumber, voucherUrl, options)
.then((response) => {
if (response.success) {
console.log(`🎉 แลกคูปองสำเร็จ: ${response.amount} สตางค์`);
} else {
handleVoucherError(response);
}
})
.catch((error) => {
console.error("❌ เกิดข้อผิดพลาดในการแลกคูปอง:", error);
});
}
// ใช้ Async/Await
async function redeemWithAsync() {
try {
const response = await redeemvouchers(phoneNumber, voucherUrl, options);
if (response.success) {
console.log(`🎉 แลกคูปองสำเร็จ: ${response.amount} สตางค์`);
} else {
handleVoucherError(response);
}
} catch (error) {
console.error("❌ เกิดข้อผิดพลาดในการแลกคูปอง:", error);
}
}
// ฟังก์ชันจัดการ Error จากการแลกคูปอง
function handleVoucherError(response: { code: string; message: string }) {
switch (response.code) {
case "VOUCHER_NOT_FOUND":
console.warn("🔍 ไม่พบคูปอง");
break;
case "VOUCHER_EXPIRED":
console.warn("⏳ คูปองหมดอายุ");
break;
case "VOUCHER_OUT_OF_STOCK":
console.warn("❌ คูปองถูกใช้ไปแล้ว");
break;
case "CANNOT_GET_OWN_VOUCHER":
console.warn("🚫 ไม่สามารถใช้คูปองตัวเองได้");
break;
case "CONDITION_NOT_MET":
console.warn("🚫 ไม่ตรงเงื่อนไข");
break;
default:
console.warn(`⚠️ การแลกคูปองล้มเหลว: ${response.message}`);
}
}
// เรียกใช้ฟังก์ชันตัวอย่าง
redeemWithPromise();
redeemWithAsync();
```
กรณีที่ไม่ได้ระบุพารามิเตอร์ options จะเป็นการ redeem โดยไม่เช็คเงื่อนไขใดๆก่อน
กรณีที่มีการระบุ options ถ้าไม่ตรงกับเงื่อนไขใดๆจะไม่ทำการ redeem
แลกคูปอง TrueMoney
- `phoneNumber`: หมายเลขโทรศัพท์ที่เชื่อมโยงกับบัญชี TrueMoney ที่ต้องการรับเงิน
- `voucherUrl`: URL คูปองอั่งเปา
- `options`: เงื่อนไขเพิ่มเติม (ถ้ามี)
- `amount`: จำนวนเงินที่ต้องการแลกในหน่วยสตางค์
คืนค่าเป็น Promise ที่ resolve เป็นวัตถุ `ReturnData`
```typescript
interface Data {
voucher: Voucher;
owner_profile: Profile;
redeemer_profile: RedeemerProfile;
my_ticket: MyTicket;
tickets: MyTicket[];
}
interface Voucher {
voucher_id: string;
amount_baht: string;
redeemed_amount_baht: string;
member: number;
status: "active" | "redeemed" | "expired";
link: string;
detail: string;
expire_date: number;
type: "R" | "F";
redeemed: number;
available: number;
}
interface Profile {
full_name: string;
}
interface RedeemerProfile {
mobile_number: string;
}
interface MyTicket {
mobile: string;
update_date: number;
amount_baht: string;
full_name: string;
profile_pic: string | null;
}
```
`Data` ประกอบด้วยข้อมูลดังนี้:
- `voucher`: ข้อมูลคูปอง
- `owner_profile`: โปรไฟล์ของเจ้าของคูปอง
- `redeemer_profile`: โปรไฟล์ของผู่ที่จะแลกคูปอง
- `my_ticket`: ข้อมูลบัญชีของผู้รับเงินแล้ว
- `tickets`: รายการข้อมูลบัญชีของผู้รับเงินแล้ว
```typescript
type Options {
amount: number; // จำนวนเงินในหน่วยสตางค์ 100-20000000
}
```
```typescript
type ReturnData =
| {
// กรณี redeem สำเร็จ
success: true;
code: "SUCCESS";
message: string; // ข้อความจาก TrueMoney
amount: number; // จำนวนเงินเป็นสตางค์
data: Data; // ข้อมูลจาก TrueMoney
}
| {
// กรณี redeem ไม่สำเร็จ
success: false;
code: string;
message: string; // ข้อความจาก TrueMoney
data?: Data | null; // ข้อมูลจาก TrueMoney
};
```
| Code | Description | Success |
| ----------------------------- | ----------------------------------- | ------- |
| `SUCCESS` | สำเร็จ | true |
| `BAD_PARAM` | พารามิเตอร์ไม่ถูกต้อง | false |
| `VOUCHER_NOT_FOUND` | ไม่พบคูปอง | false |
| `VOUCHER_OUT_OF_STOCK` | คูปองถูกใช้ไปแล้ว | false |
| `VOUCHER_EXPIRED` | คูปองหมดอายุ | false |
| `CANNOT_GET_OWN_VOUCHER` | ไม่สามารถแลกคูปองของตัวเองได้ | false |
| `TARGET_USER_NOT_FOUND` | ไม่พบหมายเลขโทรศัพท์ | false |
| `TARGET_USER_REDEEMED` | ผู้ใช้นี้เคยแลกคูปองแล้ว | false |
| `TARGET_USER_STATUS_INACTIVE` | บัญชีผู้รับถูกระงับหรือไม่ได้ใช้งาน | false |
| `CONDITION_NOT_MET` | ไม่ตรงเงื่อนไข (options) | false |
| `INVALID_INPUT` | ข้อมูลไม่ถูกต้อง | false |
| `MAINTENANCE` | อยู่ในช่วงการบำรุงรักษา | false |
| `INTERNAL_ERROR` | Internal server error | false |
> This is a third-party SDK, not an official TrueMoney.
> SDK นี้พัฒนาโดยบุคคลภายนอก ไม่ใช่ผลิตภัณฑ์อย่างเป็นทางการจาก TrueMoney
Licensed under [ISC](LICENSE)