จาก API key
ถึงบิลแรก.

สร้างบัญชีและ Merchant API Key

ไปที่ Merchant Console → สร้างบัญชีและตั้งค่าร้าน/บัญชี PromptPay → หน้า API & Checkout เพื่อคัดลอก Merchant API Key ที่แสดงครั้งเดียว. เก็บไว้ฝั่ง Server หรือ secret manager และอย่าฝังใน JavaScript ฝั่งลูกค้า

curl -sS "https://payment.cytechteam.dev/v1/merchant/profile" \
  -H "Authorization: Bearer cyt_next_REPLACE_WITH_YOUR_KEY"

สร้าง checkout

ใช้ URL เต็มในตัวอย่างได้ทันที โดยแทน cyt_next_REPLACE_WITH_YOUR_KEY ด้วย Merchant API Key จริงของร้าน และใช้ merchant_ref ใหม่ทุกบิล. ไม่ต้องตั้งค่า $BASE หรือ $KEY. การเรียก API นี้สร้างบิลจริงและมีอายุ 15 นาที

curl -X POST "https://payment.cytechteam.dev/v1/checkouts" \
  -H "Authorization: Bearer cyt_next_REPLACE_WITH_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "merchant_ref": "order-1001",
    "amount": "20.00",
    "verification_method": "decimal"
  }'

เปิดหน้าจ่ายเงิน

นำ payment_path จาก response เช่น /pay/pay_... ไปต่อท้าย https://payment.cytechteam.dev เพื่อให้ลูกค้าเปิดหน้าจ่ายเงิน หรือเรียก https://payment.cytechteam.dev/pay/<pay_id>/qr.png เพื่อรับ QR ของบิลที่ยังชำระได้

รับ webhook

ตั้ง URL แบบ public HTTPS ใน Console แล้วตรวจ X-Cytech-Signature ด้วย HMAC-SHA256 ของ timestamp + "." + raw_body ก่อนประมวลผล. ป้องกันการประมวลผลซ้ำด้วย X-Cytech-Event-ID และตอบ HTTP 2xx เมื่อสำเร็จ

signature = HMAC_SHA256(
  secret,
  timestamp + "." + raw_body
)

ตรวจสถานะ

poll GET /v1/checkouts/<pay_id> ด้วย Merchant API Key หรือดูที่ Console Transactions. เมื่อพบ PAID ระบบอ้างอิง LINE Bank Notification ไม่ใช่ Bank Settlement API

curl -sS "https://payment.cytechteam.dev/v1/checkouts/pay_REPLACE_WITH_ID" \
  -H "Authorization: Bearer cyt_next_REPLACE_WITH_YOUR_KEY"

แทน pay_REPLACE_WITH_ID ด้วย checkout.id จากผลสร้างบิล. ตรวจ confirmation_basis และ funds_received เพราะสถานะ PAID ที่ระบบยืนยันได้มาจาก LINE Bank Notification

ไปต่อ

อ่าน API reference, ดูธนาคารที่รองรับ หรือเปิด Console เพื่อจัดการ key/webhook