สร้าง QR Code

สร้าง QR Code พร้อมเพย์และร้านค้าสำหรับรับชำระเงิน

Endpoint

POST /qr/generate

URL เต็ม: https://api.thunder.in.th/v1/qr/generate

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

จำเป็น ดูคู่มือการยืนยันตัวตน

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

v1 เท่านั้น

การสร้าง QR Code มีเฉพาะใน API v1

Request

ประเภท QR ที่รองรับ

• PromptPay - QR Code พร้อมเพย์ส่วนบุคคล
• K-Shop - QR Code ร้านค้า Kasikorn
• Mae Manee - QR Code ร้านค้า Mae Manee
• Tungngern - QR Code ร้านค้า Tungngern
• Bill Payment - QR Code ชำระบิลด้วย Biller ID ที่ลงทะเบียนไว้ (Tag 30)

Type Definitions

// Request
type QRGenerateRequest = PromptPayRequest | KShopRequest | MaeManeeRequest | TungngernRequest | BillPaymentRequest;

interface BillPaymentRequest {
  type: 'BILL_PAYMENT';
  billerId: string;      // 15 หลักรวม suffix; ต้องส่งเป็น string เพื่อคงเลขศูนย์ด้านหน้า
  ref1: string;          // ASCII ที่พิมพ์ได้ 1-20 ตัว คงตัวพิมพ์เล็ก/ใหญ่
  ref2?: string;         // รูปแบบเดียวกับ ref1; ไม่ต้องส่งหากไม่ใช้
  amount?: number;       // 0.01 ถึง 9999999999.99 ทศนิยมไม่เกิน 2 ตำแหน่ง
}

interface PromptPayRequest {
  type: 'PROMPTPAY';
  msisdn?: string;               // เบอร์โทรศัพท์ (0xxxxxxxxx)
  natId?: string;                // เลขบัตรประชาชน (13 หลัก)
  eWalletId?: string;            // E-wallet ID (15 หลัก)
  amount?: number;               // จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)
}

interface KShopRequest {
  type: 'KSHOP';
  ref1: string;                  // Reference 1 (1-20 ตัวอักษร, ตัวพิมพ์ใหญ่)
  amount?: number;               // จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)
}

interface MaeManeeRequest {
  type: 'MAE_MANEE';
  ref1: string;                  // Reference 1 (1-20 ตัวอักษร, ตัวพิมพ์ใหญ่)
  amount?: number;               // จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)
}

interface TungngernRequest {
  type: 'TUNGNGERN';
  ref1: string;                  // Reference 1 (1-20 ตัวอักษร, ตัวพิมพ์ใหญ่)
  merchantName?: string;         // ชื่อร้านค้า (1-25 ตัวอักษร)
  amount?: number;               // จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)
}

// Response
interface QRGenerateResponse {
  status: 200;
  data: QRData;
}

interface QRData {
  image: string;                 // รูป PNG ที่เข้ารหัส Base64
  mime: string;                  // MIME type (image/png)
  payload: string;               // ข้อมูล QR Code Payload
}

// Error Response
interface ErrorResponse {
  status: number;
  message: string;
  details?: string | Array<{ field: string; message: string }>;
}

ตัวอย่าง Request

Bill Payment (Biller ID)

ใช้ Biller ID 15 หลักที่ลงทะเบียนกับธนาคารหรือผู้ให้บริการแล้ว เส้นนี้สร้าง QR สำหรับรับชำระเงิน ไม่ได้ออกหรือลงทะเบียน Biller ID ใหม่ และไม่ได้ตรวจสอบว่า ID นั้นเปิดใช้งานอยู่หรือไม่

{
  "type": "BILL_PAYMENT",
  "billerId": "010555123456701",
  "ref1": "INV20261014001",
  "ref2": "CUSTOMER001",
  "amount": 125.50
}

ตัวอย่าง ID ข้างต้นใช้ประกอบเอกสารเท่านั้น ให้แทนด้วย Biller ID ของคุณ

ฟิลด์	จำเป็น	รูปแบบ
billerId	ใช่	string ตัวเลข 15 หลัก รวม suffix ไม่ตัดเลขศูนย์ด้านหน้า
ref1	ใช่	ASCII ที่พิมพ์ได้ 1-20 ตัว ห้ามว่างล้วน
ref2	ไม่	รูปแบบเดียวกับ ref1; ไม่ต้องส่งหากไม่ใช้
amount	ไม่	number บวก ทศนิยมไม่เกิน 2 ตำแหน่ง สูงสุด 9999999999.99 บาท

คงค่าอ้างอิงตามที่ส่งทุกตัวอักษร ไม่เปลี่ยนเป็นตัวพิมพ์ใหญ่ ไม่ตัดช่องว่าง ให้ใช้รูปแบบอ้างอิงที่ธนาคารกำหนดสำหรับ Biller ID ของคุณ หากไม่ส่ง amount ผู้จ่ายระบุจำนวนเงินเองได้ รูปแบบ response (image, mime, payload) เหมือน QR ประเภทเดิม

รูปแบบข้อมูลอ้างอิง มาตรฐาน Thai QR Code ของ ธปท. หน้า 15

PromptPay

{
  "type": "PROMPTPAY",
  "msisdn": "0812345678",
  "amount": 100.00
}

พารามิเตอร์:

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
type	string	ใช่	"PROMPTPAY"
msisdn	string	เลือก 1	เบอร์โทรศัพท์ (0xxxxxxxxx)
natId	string	เลือก 1	เลขบัตรประชาชน (13 หลัก)
eWalletId	string	เลือก 1	E-wallet ID (15 หลัก)
amount	number	ไม่	จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)

TIP

ต้องระบุ 1 อย่างจาก: msisdn, natId หรือ eWalletId

K-Shop

{
  "type": "KSHOP",
  "ref1": "ORDER12345",
  "amount": 250.00
}

พารามิเตอร์:

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
type	string	ใช่	"KSHOP"
ref1	string	ใช่	Reference 1 (1-20 ตัวอักษร, ตัวพิมพ์ใหญ่)
amount	number	ไม่	จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)

Mae Manee

{
  "type": "MAE_MANEE",
  "ref1": "ORDER12345",
  "amount": 500.00
}

พารามิเตอร์:

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
type	string	ใช่	"MAE_MANEE"
ref1	string	ใช่	Reference 1 (1-20 ตัวอักษร, ตัวพิมพ์ใหญ่)
amount	number	ไม่	จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)

Tungngern

{
  "type": "TUNGNGERN",
  "ref1": "ORDER12345",
  "merchantName": "ร้านของฉัน",
  "amount": 750.00
}

พารามิเตอร์:

พารามิเตอร์	ประเภท	จำเป็น	คำอธิบาย
type	string	ใช่	"TUNGNGERN"
ref1	string	ใช่	Reference 1 (1-20 ตัวอักษร, ตัวพิมพ์ใหญ่)
merchantName	string	ไม่	ชื่อร้านค้า (1-25 ตัวอักษร)
amount	number	ไม่	จำนวนเงิน (ทศนิยม 2 ตำแหน่ง)

ตัวอย่าง

cURL

curl -X POST https://api.thunder.in.th/v1/qr/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "PROMPTPAY",
    "msisdn": "0812345678",
    "amount": 100.00
  }'

JavaScript

const generateQR = async (config) => {
  const response = await fetch('https://api.thunder.in.th/v1/qr/generate', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(config)
  });

  const result = await response.json();

  if (result.status !== 200) {
    throw new Error(result.message);
  }

  return result.data;
};

// สร้าง PromptPay QR
const promptPayQR = await generateQR({
  type: 'PROMPTPAY',
  msisdn: '0812345678',
  amount: 100.00
});

// แสดง QR Code
const img = document.createElement('img');
img.src = `data:${promptPayQR.mime};base64,${promptPayQR.image}`;
document.body.appendChild(img);

// สร้าง K-Shop QR
const kshopQR = await generateQR({
  type: 'KSHOP',
  ref1: 'ORDER12345',
  amount: 250.00
});

PHP

function generateQR(array $config): array
{
    $apiKey = getenv('THUNDER_API_KEY');

    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => 'https://api.thunder.in.th/v1/qr/generate',
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_HTTPHEADER => [
            'Authorization: Bearer ' . $apiKey,
            'Content-Type: application/json'
        ],
        CURLOPT_POSTFIELDS => json_encode($config)
    ]);

    $response = curl_exec($ch);
    curl_close($ch);

    $result = json_decode($response, true);

    if ($result['status'] !== 200) {
        throw new Exception($result['message']);
    }

    return $result['data'];
}

// สร้าง PromptPay QR
$qr = generateQR([
    'type' => 'PROMPTPAY',
    'msisdn' => '0812345678',
    'amount' => 100.00
]);

// บันทึกเป็นไฟล์
$imageData = base64_decode($qr['image']);
file_put_contents('qr-code.png', $imageData);

// หรือแสดงในหน้าเว็บ
echo '<img src="data:' . $qr['mime'] . ';base64,' . $qr['image'] . '">';

Python

import requests
import base64
import os

def generate_qr(config: dict) -> dict:
    response = requests.post(
        'https://api.thunder.in.th/v1/qr/generate',
        headers={
            'Authorization': f'Bearer {os.environ["THUNDER_API_KEY"]}',
            'Content-Type': 'application/json'
        },
        json=config
    )

    result = response.json()

    if result['status'] != 200:
        raise Exception(result['message'])

    return result['data']

# สร้าง PromptPay QR
qr = generate_qr({
    'type': 'PROMPTPAY',
    'msisdn': '0812345678',
    'amount': 100.00
})

# บันทึกเป็นไฟล์
image_data = base64.b64decode(qr['image'])
with open('qr-code.png', 'wb') as f:
    f.write(image_data)

print(f"Payload: {qr['payload']}")

Response

สำเร็จ (200)

{
  "status": 200,
  "data": {
    "image": "iVBORw0KGgoAAAANSUhEUgAA...",
    "mime": "image/png",
    "payload": "00020101021230..."
  }
}

ฟิลด์ใน Response

ฟิลด์	ประเภท	คำอธิบาย
image	string	รูป PNG ที่เข้ารหัส Base64
mime	string	MIME type (image/png)
payload	string	ข้อมูล QR Code Payload

Error Responses

Request ไม่ถูกต้อง (400)

{
  "status": 400,
  "message": "invalid_request",
  "details": [
    { "field": "ref1", "message": "Required" }
  ]
}

ไม่ได้รับอนุญาต (401)

{
  "status": 401,
  "message": "unauthorized"
}

หมายเหตุ

• การสร้าง QR Code ไม่หักโควต้าการตรวจสอบ
• QR Code ที่สร้างใช้ได้ตลอดไป
• จำนวนเงินเป็น Optional - ลูกค้าสามารถกรอกจำนวนเงินเองเมื่อจ่าย
• ref1 ของ KSHOP, MAE_MANEE และ TUNGNGERN รับตัวอักษรและตัวเลข และเปลี่ยนเป็นตัวพิมพ์ใหญ่ ส่วน BILL_PAYMENT คงตัวพิมพ์เล็ก/ใหญ่และรับ ASCII ที่พิมพ์ได้

ที่เกี่ยวข้อง

• ตรวจสอบสลิปธนาคาร
• รหัส Error