การทำระบบรับชำระเงินผ่าน True Money Wallet

ในบทความนี้ผมจะมาพูดถึงการทำระบบชำระเงินผ่าน True Money Wallet ซึ่งจะเป็นลักษณะ webhook โดยทาง truewallet จะส่งข้อมูลมาบอกเราทุกครั้งที่มีรายการเกิดขึ้น เช่น มีการเติมเงินเข้า truewallet, มีการโอนเข้า truewallet ไม่ว่าเป็นเป็นทาง truewallet เองหรือจะเป็น promptpay ก็จะส่งข้อมูลมาบอกเราทั้งหมด

ซึ่งบริการนี้ก็มีมาตั้งแต่ปี 2022 ละ อ้างอิงจาก มีผู้ใช้งาน TrueMoney Wallet พบว่ามีฟีเจอร์ใหม่ในแอพฯ ว่าถ้าหากมีรายการรับเงิน 100 ครั้งขึ้นไป นั้นแหละตอนนั้นผมก็ได้ลองใช้งานดูก็ถือว่าใช้งานได้ดีเลยทีเดียว แต่วิธีเข้าหน้าจัดการค่อยข้างยากตั้งแต่วันนั้นถึงวันนี้ ก็ยังเหมือนเดิม แต่ตอนนี้ก็มีฟีเจอร์อื่นๆเพิ่มเติมมาด้วย จากเดิมที่แค่ webhook เท่านั้น

เงื่อนไขการใช้งาน#

การที่จะใช้ฟีเจอร์ webhook หรือ inquiry service ได้นั้น บัญชีของเราจะต้องมีรายการรับเงิน 100 รายการ และ 10 บาทต่อรายการ (ถ้ามีรายการไม่ถึง 100 รายการก็แค่ปั้มเลยสิ โอนเข้ามา 100 ครั้ง ครั้งละ 10 บาท)

วิธีเข้าหน้าจัดการ#

เข้าไปที่ลิ้ง https://tmn.app.link/PFCCLT ลิ้งจะเปิดแอพ truewalletและเปิดหน้าจัดการให้เลย
Scan QR Code ตามลิ้งด้านล่าง ผ่านแอพ truewallet ก็ได้เหมือนกัน

เอกสารคู่มือการใช้งาน Webhook API#

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

ผู้ใช้จะได้รับข้อมูล Response Data เป็นแบบ Json

1
{
2
    "message": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJldmVudF90eXBlIjoiUDJQIiwicmVjZWl2ZWRfdGltZSI6IjIwMjItMDEtMzFUMTM6MDI6MjMrMDcwMCIsImFtb3VudCI6MTAwMDAsInNlbmRlcl9tb2JpbGUiOiIwMTIzNDU2Nzg5IiwibWVzc2FnZSI6IiIsImlhdCI6MTY1MzUzODc5M30.wb-4vOY6ASVl3nVlALC0y1TIl-Gs0XEk5AqYdqtoFz0"
3
}

ผู้ใช้งานสามารถนำข้อมูลของ message (JWT web token) ไปใช้ได้โดยการ Decode Base64

1
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJldmVudF90eXBlIjoiUDJQIiwicmVjZWl2ZWRfdGltZSI6IjIwMjItMDEtMzFUMTM6MDI6MjMrMDcwMCIsImFtb3VudCI6MTAwMDAsInNlbmRlcl9tb2JpbGUiOiIwMTIzNDU2Nzg5IiwibWVzc2FnZSI6IiIsImlhdCI6MTY1MzUzODc5M30.wb-4vOY6ASVl3nVlALC0y1TIl-Gs0XEk5AqYdqtoFz0

โดยข้อมูลแบ่งออกเป็น 3 ส่วนตามสี ดังนี้

HEADER (Decode ได้ด้วย Base64)

1
{
2
    "alg": "HS256",
3
    "typ": "JWT",
4
}

PAYLOAD (Decode ได้ด้วย Base64)

1
{
2
    "event_type": "P2P",
3
    "received_time": "2022-01-31T13:02:23+0700",
4
    "amount": 10000,
5
    "sender_mobile": "0123456789",
6
    "message": "ค่าไอเทม",
7
    "iat": 1653538793
8
}

VERIFY SIGNATURE (ALG HS256)

1
wb-4vOY6ASVl3nVlALC0y1TIl-Gs0XEk5AqYdqtoFz0

ด้วย Secret

018db5a1098fde137da6856eab3d26d7

หมายเหตุ*

สามารถนำ message ไปตรวจสอบได้ที่ URL : https://jwt.io/ และ JWT Verify Signature ของคุณสามารถดูได้จากรูปด้านล่าง ซึ่งจากข้อมูลตัวอย่างนี้ JWT Verify Signature คือ “018db5a1098fde137da6856eab3d26d7”

Example Lib for work with Json web token https://www.npmjs.com/package/jsonwebtoken

รายละเอียดข้อมูล “รับเงิน”#

(โอนเงินจากวอลเล็ท, รับเงินจากลิงก์รับเงิน)

ในกรณี รับเงินโอนเงินจากวอลเล็ท

PAYLOAD (Decode ได้ด้วย Base64)

1
{
2
    "event_type": "P2P",
3
    "received_time": "2022-01-31T13:02:23+0700",
4
    "amount": 10000,
5
    "sender_mobile": "",
6
    "message": "ค่าไอเทม",
7
    "channel": ""
8
}

ในกรณี รับเงินโอนเงินจากวอลเล็ท ข้อมูลในส่วนของ

received_time: เวลาที่ได้รับเงินโอนจากวอลเล็ท
amount: จำนวนเงินโดยมีหน่วยเป็นสตางค์
sender_mobile: ข้อมูลคนที่ส่งเงิน
message: ข้อความที่ทางผู้โอนเงินเขียนมาให้
channel: จะส่งข้อมูลเป็น empty string ไปให้

ในกรณี รับเงินจากลิงก์รับเงิน

PAYLOAD (Decode ได้ด้วย Base64)

1
{
2
    "event_type": "MONEY_LINK",
3
    "received_time": "2022-01-31T13:02:23+0700",
4
    "amount": 10000,
5
    "sender_mobile": "0123456789",
6
    "message": "",
7
    "channel": ""
8
}

ในกรณี รับเงินจากลิงก์รับเงิน ข้อมูลในส่วนของ

received_time: เวลาที่ได้รับเงินโอนจากวอลเล็ท
amount: จำนวนเงินโดยมีหน่วยเป็นสตางค์
sender_mobile: ข้อมูลคนที่ส่งเงิน
message: จะส่งข้อมูลเป็น empty string ไปให้
channel: จะส่งข้อมูลเป็น empty string ไปให้

รายละเอียดข้อมูล “เติมเงิน”#

(เติมจากร้านค้า, ธนาคาร, พร้อมเพย์)

ในกรณี เติมจากร้านค้า, ธนาคาร

PAYLOAD (Decode ได้ด้วย Base64)

1
{
2
    "event_type": "DIRECT_TOPUP",
3
    "received_time": "2022-01-31T13:02:23+0700",
4
    "amount": 10000,
5
    "sender_mobile": "0811111111",
6
    "message": "",
7
    "channel": "7-Eleven"
8
}

ในกรณี เติมจากร้านค้า, ธนาคาร ข้อมูลในส่วนของ

received_time: เวลาที่เติมจากร้านค้า, ธนาคาร
amount: จำนวนเงินโดยมีหน่วยเป็นสตางค์
sender_mobile: ข้อมูลคนที่ส่งเงิน
message: จะส่งข้อมูลเป็น empty string ไปให้
channel: ช่องทางการเติมเงิน ตัวอย่างข้อมูล “7-Eleven”

ในกรณี เติมจากพร้อมเพย์

PAYLOAD (Decode ได้ด้วย Base64)

1
{
2
    "event_type": "PROMPTPAY_IN",
3
    "received_time": "2022-01-31T13:02:23+0700",
4
    "amount": 10000,
5
    "sender_mobile": "0123456789",
6
    "message": "",
7
    "channel": ""
8
}

ในกรณี พร้อมเพย์ ข้อมูลในส่วนของ

received_time: เวลาที่ได้รับเงินจากพร้อมเพย์
amount: จำนวนเงินโดยมีหน่วยเป็นสตางค์
sender_mobile: ข้อมูลคนที่ส่งเงิน
message: จะส่งข้อมูลเป็น empty string ไปให้
channel: จะส่งข้อมูลเป็น empty string ไปให้

Flow การทำงาน#

จากรูป flow ก็จะเห็นว่าเราไม่ได้ส่ง request ไปที่ truewallet เลย แต่จะเป็นทาง truewallet ที่จะส่งมาหาเราเอง ถ้ามี event เกิดขึ้น

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

ตรงนี้ก็จะเป็นแค่ตัวอย่างเท่านั้น โดยจะมีอยู่ 2 ไฟล์

index.php คือหน้า UI ที่จะแสดง QR CODE ให้ลูกค้าแสกน
webhook.php คือ url endpoint ที่จะเอาไปใส่ในแอพ เพื่อที่จะให้ truewallet ส่งข้อมูลมาให้เรา

library ที่จะใช้งาน

index.php

1
<script src="https://cdn.jsdelivr.net/npm/promptparse"></script>
2

3
<script>
4
  ;(function () {
5
    // Generate QR code payload (use function from "promptparse" global)
6
    const payload = promptparse.generate.trueMoney({
7
      mobileNo: '08xxxxxxxx',
8
      amount: 10.0,
9
      message: 'INV1234',
10
    })
11

12
    // Quick & dirty way to show QR Code image
13
    document.write(
14
      `<img src="https://api.qrserver.com/v1/create-qr-code/?size=300x300&data=${payload}">`,
15
    )
16
  })()
17
</script>

webhook.php

1
<?php
2
require_once 'vendor/autoload.php';
3

4
use Firebase\JWT\JWT;
5
use Firebase\JWT\Key;
6

7
header('Accept: application/json');
8
header('Content-Type: application/json');
9

10
try {
11
    $key = 'fb7xxxxxxxxxxxxxxxxxxxxxxxxx'; // key ที่ได้หลังจากกรอก url endpoint
12

13
    $request = json_decode(file_get_contents('php://input'), true);
14

15
    $jwt = $request['message'];
16

17
    $data = JWT::decode($jwt, new Key($key, 'HS256'));
18

19
    $event_type = $data->event_type;
20
    $invoice = $data->message;
21
    $amount = $data->amount;
22

23
    switch ($event_type) {
24
        case 'P2P':
25
            // if ($amount == $order_amount) {
26
            //     $sql = "UPDATE `orders` SET `status`='success' WHERE `invoice`='$invoice'"
27
            // }
28
            // ตรงนี้แล้วแต่จะเขียนเลยว่าอยากจะทำอะไรต่อ
29
            break;
30
        case 'MONEY_LINK':
31
            // if ($amount == $order_amount) {
32
            //     $sql = "UPDATE `orders` SET `status`='success' WHERE `invoice`='$invoice'"
33
            // }
34
            // ตรงนี้แล้วแต่จะเขียนเลยว่าอยากจะทำอะไรต่อ
35
            break;
36
        case 'DIRECT_TOPUP':
37
            // if ($amount == $order_amount) {
38
            //     $sql = "UPDATE `orders` SET `status`='success' WHERE `invoice`='$invoice'"
39
            // }
40
            // ตรงนี้แล้วแต่จะเขียนเลยว่าอยากจะทำอะไรต่อ
41
            break;
42
        case 'PROMPTPAY_IN':
43
            // if ($amount == $order_amount) {
44
            //     $sql = "UPDATE `orders` SET `status`='success' WHERE `invoice`='$invoice'"
45
            // }
46
            // ตรงนี้แล้วแต่จะเขียนเลยว่าอยากจะทำอะไรต่อ
47
            break;
48

49
        default:
50
            echo json_encode([
51
                'message' => 'error'
52
            ]);
53
            exit();
54
            break;
55
    }
56

57
    echo json_encode([
58
        'message' => 'complate'
59
    ]);
60
} catch (\Throwable $th) {
61
    echo json_encode([
62
        'message' => $th->getMessage()
63
    ]);
64
}