คู่มือใช้งานระบบรับชำระเงิน PayNex

สำหรับร้านค้า / ลูกค้าที่ต้องการรับชำระเงินผ่าน PromptPay QR, Credit Card และ Mobile Banking ตามมาตรฐานสากล

PromptPay QR

Dynamic QR ตามมาตรฐาน EMVCo ธปท.

Credit Card

Visa / Mastercard ปลอดภัย PCI-DSS

Mobile Banking

แอปธนาคารทุกธนาคารในไทย

PayNex รับชำระเงินทันทีผ่าน QR Code แบบ Dynamic (ทุกครั้งสร้าง QR ใหม่ ไม่ซ้ำกัน กันปลอมแปลง), ตัดเงินเข้าบัญชีพร้อมเพย์ของร้านค้า และยืนยันผลกลับหากร้านค้าแบบเรียลไทม์ผ่าน Webhook ตามมาตรฐานธนาคารแห่งประเทศไทย (ธปท.)

มาตรฐานที่รองรับ

มาตรฐาน	รายละเอียด
EMVCo	PromptPay QR ตามมาตรฐานสากล EMVCo Merchant-Presented QR — สแกนด้วยแอปธนาคารใดก็ได้ในไทย
ธปท. / NFCC	สอดคล้องหลักเกณฑ์ National PromptPay QR Code Standard และข้อกำหนดของธนาคารแห่งประเทศไทย
PCI-DSS	ข้อมูลบัตรเครดิตไม่ผ่าน/ไม่เก็บในระบบ PayNex — ลดขอบเขต PCI-DSS ของร้านค้า
AML-CFT / e-KYC	ตรวจสอบร้านค้าตามกฎหมาย ป้องกันการฟอกเงินและสนับสนุนการเงินผู้ก่อการร้าย

เริ่มต้นใช้งาน 4 ขั้นตอน

สมัครและยืนยันตัวตน (e-KYC)

ลงทะเบียนร้านค้าออนไลน์ ยืนยันตัวตนกับ DOPA และตรวจ AML Watchlist — ทีม Compliance ตรวจสอบและอนุมัติ

รับ API Key และตั้งค่า Webhook

ระบบสร้าง API Key ให้ร้านค้า ตั้งค่า Webhook URL เพื่อรับผลการชำระเงินอัตโนมัติ + ทดสอบส่ง Webhook

สร้างรายการชำระเงิน (Charge)

เรียก API POST /api/v1/charges ระบุยอดเงินและวิธีชำระ — ระบบคืน QR Code / redirect ไปหน้า Checkout

ลูกค้าจ่ายเงิน และรับการยืนยัน

ลูกค้าสแกน QR / กรอกบัตร → ระบบแจ้งผลผ่าน Webhook + หน้า Checkout อัปเดตสถานะแบบเรียลไทม์ (SSE)

                        # ตัวอย่าง: สร้างรายการชำระเงิน PromptPay ฿499

                        curl https:///api/v1/charges \

                          -H "X-Merchant-Id: mer_demo" \

                          -H "Content-Type: application/json" \

                          -d '{"amount": 499, "payment_method": "promptpay", "description": "Order #1001"}'

วิธีชำระเงินของลูกค้า

รองรับ 3 ช่องทางตามมาตรฐาน Payment — เลือกช่องทางได้ในการสร้าง Charge

1. PromptPay QR (ตามมาตรฐาน EMVCo)

สร้าง QR แบบ Dynamic — ทุกรายการมี QR ใหม่พร้อมยอดเงินที่กำหนด ไม่สามารถแก้ยอดได้ กันการปลอมแปลง
ลูกค้าเปิดแอปธนาคาร (ทุกธนาคารที่รองรับ National QR) เลือก "สแกนจ่าย" แล้วสแกน
QR แสดงยอดเงินและชื่อร้านค้าโดยอัตโนมัติ ลูกค้ากดยืนยันจ่ายผ่าน PIN / Biometric
โหมด Sandbox ใช้ร้านค้า Demo (Merchant ID: mer_demo) ที่มีบัญชีพร้อมเพย์จำลอง — อย่าใช้สแกนจ่ายจริง ให้ใช้ endpoint POST /sandbox/payments/:id/simulate จำลองผลการชำระเงินแทน

การเปิดใช้งานจริงต้องตั้งค่าเป็นโหมด Production และตรวจสอบให้แน่ใจว่าบัญชีพร้อมเพย์ของร้านค้ารับเงินได้

2. Credit Card (Visa / Mastercard)

ลูกค้ากรอกข้อมูลบัตรในหน้า Checkout ที่เข้ารหัส TLS 1.2+ และเป็นไปตาม PCI-DSS
ข้อมูลบัตรไม่ถูกเก็บในระบบ PayNex — ลดความเสี่ยงและขอบเขต PCI-DSS ของร้านค้า
ยืนยันผ่าน 3-D Secure (ถ้า gateway รองรับ) เพื่อป้องกันบัตรปลอม

3. Mobile Banking (ทุกธนาคารในไทย)

ลูกค้าจ่ายผ่านแอปธนาคารตามบัญชีพร้อมเพย์ / บิลเลอร์ที่ร้านค้ากำหนด
ระบบตรวจสอบสถานะการชำระเงินและแจ้งผลร้านค้าอัตโนมัติผ่าน Webhook

Webhook & Callback

เมื่อลูกค้าจ่ายเงินสำเร็จ ระบบจะส่ง Webhook ไปยัง URL ของร้านค้าเพื่อยืนยันยอดและตัดสินค้า/บริการ

ตั้งค่า URL ใน Merchant Dashboard และทดสอบการส่งได้ทันที
รองรับ retry อัตโนมัติเมื่อ gateway ของร้านค้าล่ม + ประวัติการส่ง (Webhook Logs)
มีการเซ็น signature (HMAC) เพื่อให้ร้านค้าตรวจสอบว่ามาจาก PayNex จริง
แนะนำให้ตอบกลับ 200 OK ทันทีที่รับได้ เพื่อกันการส่งซ้ำ

                        # ตัวอย่าง payload webhook ที่ร้านค้าได้รับ

                        {

                          "id": "chg_...", "event": "charge.succeeded",

                          "charge_id": "chg_...", "status": "SUCCEEDED",

                          "amount": 499, "currency": "THB",

                          "reference": "order-1001",

                          "ref_no": "TXN-...", "paid_at": "2026-08-08T07:23:45Z"

                        }

ความปลอดภัย (PCI-DSS)

API Key

Secret Key ใช้ได้เฉพาะฝั่ง Server เท่านั้น อย่านำไปวางในหน้าเว็บหรือแอป

Webhook Signature

ยืนยันทุก Webhook ด้วย HMAC ก่อนนำไปประมวลผล

TLS 1.2+

ทุกการเชื่อมต่อเข้ารหัส SSL/TLS ตลอดการส่งข้อมูล

ไม่เก็บเลขบัตร

PAN ไม่อยู่ในระบบ — ลดขอบเขต PCI-DSS ของร้านค้า

e-KYC + AML

ตรวจสอบตัวตนและ Watchlist ก่อนเปิดรับชำระเงินจริง

Session Timeout

ล็อกออตอัตโนมัติหลังไม่ใช้งาน 15 นาที (Admin)

คำถามที่พบบ่อย

ลูกค้าสแกน QR ด้วยแอปอะไรได้บ้าง?

แอปธนาคารทุกธนาคารในไทยที่รองรับ National QR (PromptPay) เช่น K+, SCB Easy, Krungthai NEXT, TrueMoney Wallet ฯลฯ

ยอดเงินใน QR แก้ได้ไหม?

ไม่ได้ — PayNex ใช้ Dynamic QR ฝังยอดเงินและอ้างอิงรายการไว้ล่วงหน้า ป้องกันการแก้ไขหรือจ่ายเงินผิดยอด

ร้านค้ารู้ได้อย่างไรว่าลูกค้าจ่ายเงินแล้ว?

ผ่าน Webhook แจ้งผลทันทีเมื่อสถานะเป็น SUCCEEDED + หน้า Checkout อัปเดตเรียลไทม์ และร้านค้าตรวจสอบได้ใน Merchant Dashboard / API

ทดสอบก่อนเปิดใช้จริงได้ไหม?

ได้ — โหมด Sandbox ใช้ร้านค้า Demo (mer_demo) และมี endpoint จำลองผลการชำระเงิน POST /sandbox/payments/:id/simulate ให้ทดสอบครบทั้ง Webhook

เงินเข้าบัญชีร้านค้าเมื่อไหร่?

ตามรอบตัดจ่ายเงิน (Settlement Cycle) ที่ระบบกำหนดให้สอดคล้องกับหลักเกณฑ์ธนาคารแห่งประเทศไทย (ธปท.) — ค่าเริ่มต้น 7 วันหลังชำระเงิน (ตั้งได้ 1–30 วัน) โดยหักค่าธรรมเนียม MDR Rate ตามที่ตกลง จากนั้นร้านค้าขอถอน (Payout) เข้าบัญชีธนาคารได้

ดู API Documentation ฉบับเต็ม