เอกสาร API

เริ่มต้นใช้งาน

เรียก endpoint นี้แล้วนำ URL ไปใช้เป็นรูปภาพได้ทันที

GET https://promptpay.paynoi.com/api.php?id={PromptPayID}&amount={จำนวนเงิน}

ตัวอย่าง

<img src="https://promptpay.paynoi.com/api.php?id=0812345678&amount=100">

QR ที่ได้จากตัวอย่างด้านบน

พารามิเตอร์

รูปแบบผลลัพธ์

PNG (ค่าเริ่มต้น)

https://promptpay.paynoi.com/api.php?id=0812345678&amount=100

SVG

https://promptpay.paynoi.com/api.php?id=0812345678&amount=100&format=svg

JSON

https://promptpay.paynoi.com/api.php?id=0812345678&amount=100&format=json

{
  "success": true,
  "payload": "00020101021229370016A000000677010111...",
  "id_type": "mobile",
  "amount": 100,
  "qr_url": "https://promptpay.paynoi.com/api.php?id=0812345678&amount=100"
}

payload คือข้อความมาตรฐาน EMVCo นำไปสร้าง QR ด้วยไลบรารีของคุณเองได้

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

PHP

$url = 'https://promptpay.paynoi.com/api.php?'
     . http_build_query(['id' => '0812345678', 'amount' => 100]);
echo '<img src="' . htmlspecialchars($url) . '">';

JavaScript

const url = `https://promptpay.paynoi.com/api.php?id=0812345678&amount=100`;
document.getElementById('qr').src = url;

// หรือดึง payload
const res = await fetch(url + '&format=json');
const data = await res.json();
console.log(data.payload);

Python

import requests
r = requests.get('https://promptpay.paynoi.com/api.php',
                 params={'id': '0812345678', 'amount': 100, 'format': 'json'})
print(r.json()['payload'])

ข้อผิดพลาด

หากพารามิเตอร์ไม่ถูกต้อง API จะคืนสถานะ 400 พร้อม JSON

{
  "success": false,
  "error": "PromptPay ID ไม่ถูกต้อง (ต้องเป็นเบอร์ 10 หลัก, บัตรประชาชน 13 หลัก หรือ e-Wallet 15 หลัก)"
}

ต้องการตรวจสอบเงินเข้าอัตโนมัติ?

Paynoi มีบริการตรวจสอบและแจ้งเตือนเงินเข้าบัญชีแบบเรียลไทม์ผ่าน Webhook รองรับ SCB, KBank, กรุงศรี, กรุงไทย และ G Wallet

ดูรายละเอียดที่ paynoi.com →