API Documentation

API นี้ช่วยให้คุณสร้าง QR Code สำหรับการชำระเงินในประเทศไทยได้ง่ายๆ โดยรองรับทั้ง SCB (MaeManee), KBANK (K-Shop) และ PromptPay ทั่วไป

1. การสร้าง QR Code รูปภาพ

API จะส่งกลับรูปภาพ QR Code ในรูปแบบ PNG สามารถใช้ในเว็บไซต์หรือแอปพลิเคชันของคุณได้ทันที

SCB (MaeManee)

GET http://qr-code.oiio.download/img/maemanee/{shop_id}/{amount}/{reference}

Parameter	Description	Required
shop_id	รหัสร้านค้า (เช่น 014000000000000)	Yes
amount	จำนวนเงิน (เช่น 100.00)	Yes
reference	เลขอ้างอิงการชำระเงิน	No

ตัวอย่าง:

http://qr-code.oiio.download/img/maemanee/014000000000000/100.00/INVOICE001

KBANK (K-Shop)

GET http://qr-code.oiio.download/img/k-shop/{shop_id}/{amount}/{reference}

Parameter	Description	Required
shop_id	รหัสร้านค้า (เช่น 014000000000000)	Yes
amount	จำนวนเงิน (เช่น 100.00)	Yes
reference	เลขอ้างอิงการชำระเงิน	No

ตัวอย่าง:

http://qr-code.oiio.download/img/k-shop/014000000000000/150.50/INVOICE002

PromptPay

GET http://qr-code.oiio.download/img/promptpay/{type}/{number}/{amount}

Parameter	Description	Required
type	ประเภท PromptPay (phone, id, tax)	Yes
number	หมายเลข (เบอร์โทรศัพท์, เลขบัตรประชาชน, เลขประจำตัวผู้เสียภาษี)	Yes
amount	จำนวนเงิน (เช่น 100.00)	Yes

ตัวอย่าง (เบอร์โทรศัพท์):

http://qr-code.oiio.download/img/promptpay/phone/0812345678/250.00

2. การดูข้อมูล Payload

หากคุณต้องการเฉพาะข้อมูล Payload แทนรูปภาพ สามารถใช้ API ต่อไปนี้ ซึ่งจะส่งกลับข้อมูลในรูปแบบ JSON

SCB (MaeManee) Payload

GET http://qr-code.oiio.download/payload/maemanee/{shop_id}/{amount}/{reference}

ตัวอย่าง: http://qr-code.oiio.download/payload/maemanee/014000000000000/100.00/INVOICE001

{
  "payload": "00020101021129370016A000000677010112011501075360001028602150140000000000003103INVOICE00153037645404100.005802TH622007160000000000085234630429D9",
  "details": {
    "qrType": "maemanee",
    "shopId": "014000000000000",
    "ref": "INVOICE001",
    "amount": "100.00"
  }
}

KBANK (K-Shop) Payload

GET http://qr-code.oiio.download/payload/k-shop/{shop_id}/{amount}/{reference}

ตัวอย่าง: http://qr-code.oiio.download/payload/k-shop/014000000000000/150.50/INVOICE002

{
  "payload": "00020101021130750016A000000677010112011501075360003150802150140000000000003110INVOICE00231630016A000000677010113010300402150140000000000004110INVOICE0025303764540615050.505802TH6304DE5F",
  "details": {
    "qrType": "k-shop",
    "shopId": "014000000000000",
    "ref": "INVOICE002",
    "amount": "150.50"
  }
}

PromptPay Payload

GET http://qr-code.oiio.download/payload/promptpay/{type}/{number}/{amount}

ตัวอย่าง: http://qr-code.oiio.download/payload/promptpay/phone/0812345678/250.00

{
  "payload": "00020101021129370016A000000677010111011300668123456785802TH5303764540625000.0063047E2D",
  "details": {
    "type": "phone",
    "number": "0812345678",
    "amount": "250.00"
  }
}

3. การนำไปใช้งาน

คุณสามารถเรียกใช้ API โดยตรงเพื่อสร้าง QR Code ในแอปพลิเคชันหรือเว็บไซต์ของคุณ

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

<img src="http://qr-code.oiio.download/img/maemanee/014000000000000/100.00/INVOICE001" 
     alt="PromptPay QR Code" 
     width="200">

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

// นำ QR Code ไปแสดงในหน้าเว็บ
fetch('http://qr-code.oiio.download/payload/maemanee/014000000000000/100.00/INVOICE001')
  .then(response => response.json())
  .then(data => {
    console.log('QR Payload:', data.payload);
    
    // สร้าง QR Code ด้วย library อื่นๆ
    // หรือนำไปใช้งานตามต้องการ
  })
  .catch(error => console.error('Error:', error));

4. หมายเหตุ

พารามิเตอร์ reference เป็นตัวเลือก สามารถละไว้ได้
จำนวนเงินต้องเป็นตัวเลขทศนิยม เช่น 100.00, 250.50
สำหรับ PromptPay ประเภท phone ระบบจะจัดรูปแบบเบอร์โทรศัพท์ให้อัตโนมัติ โดยเพิ่มรหัสประเทศไทย (66)
QR Code ที่สร้างขึ้นสามารถใช้ได้กับทุกธนาคารในประเทศไทยที่รองรับระบบ PromptPay