REST ที่คาดเดาได้
ทุก response เป็น { success, data, meta } หรือ { success, error } เขียน error handling ครั้งเดียวใช้ได้ทุก endpoint
REST API ที่อ่านง่าย เรียกด้วย HTTP ธรรมดาได้ทุกภาษา idempotency key ป้องกันจ่ายซ้ำ และ webhook ที่เซ็นลายเซ็นทุกครั้ง พร้อม Sandbox ที่ยิงทดสอบได้ไม่จำกัดก่อนขึ้น production
เอกสารไม่ครบ ไม่มี sandbox ที่ใช้ได้จริง และ webhook ที่เชื่อถือไม่ได้
เอกสารกระจัดกระจาย ไม่มีตัวอย่างโค้ด
ทีมต้องเดา field ต้องเมลถามซัพพอร์ต รอคำตอบข้ามวัน งานค้างทั้ง sprint
ลูกค้ากดจ่ายซ้ำ กลายเป็นเก็บเงินสองรอบ
ไม่มี idempotency ทำให้ retry หรือเน็ตหลุดสร้างรายการซ้ำ ต้องมาตามคืนเงินทีหลัง
Webhook หล่นหาย ยอดไม่ตรง
ไม่มี retry ไม่มีลายเซ็น ตรวจไม่ได้ว่าของจริงหรือปลอม ต้องเขียน cron มา reconcile เอง
เอกสารครบ ตัวอย่าง HTTP 5 ภาษา
ตัวอย่าง cURL, Node.js, PHP, Python และ Go ที่ใช้แค่ไลบรารีมาตรฐานของภาษา ไม่ต้องติดตั้งแพ็กเกจของเรา
Idempotency-Key ทุก endpoint ที่สร้างเงิน
ยิงซ้ำด้วยคีย์เดิมได้ผลลัพธ์เดิม ไม่เกิดรายการซ้ำแน่นอน
Webhook เซ็น HMAC + retry 5 ครั้ง
Exponential backoff 1 นาที → 12 ชั่วโมง พร้อม event log ให้ replay ย้อนหลังได้เอง
ฟีเจอร์หลัก
ออกแบบจากสิ่งที่ทีมวิศวกรไทยบ่นกับ gateway เจ้าอื่นมาตลอด
ทุก response เป็น { success, data, meta } หรือ { success, error } เขียน error handling ครั้งเดียวใช้ได้ทุก endpoint
สร้าง จำกัดสิทธิ์ และหมุนคีย์ได้จากหลังบ้าน เห็น log การใช้งานทุกคีย์ว่ายิงจาก IP ไหน
charge.succeeded, refund.created, settlement.paid และอื่น ๆ เลือก subscribe เฉพาะที่ต้องใช้
ทีมส่วนใหญ่ขึ้น production ได้ภายใน 1–2 วันทำการ
ขั้นที่ 1
สมัครแล้วรับ test key ทันทีจากเมนู API Keys ไม่ต้องรอ approve
sk_test_…
ขั้นที่ 2
copy ตัวอย่างโค้ดไปรัน ได้ QR หรือ redirect URL กลับมาใช้ทดสอบได้ทันที
POST /v1/charges
ลองใช้งาน
สร้างลิงก์ชำระเงินหนึ่งลิงก์ พร้อม API key, idempotency key และตัวอย่าง response จริง
curl -X POST https://api.paydy.ai/v1/merchant/payment-links \
-H "Authorization: Bearer $PAYDY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: idem_createpaymentlink_001" \
-d '{
"store_id": "01JQ8V0STORE00000000000001",
"title": "WINMAX Order #10428",
"amount": 1290,
"channels_enabled": [
"promptpay",
"visa",
"mastercard"
],
"expires_in_hours": 24,
"reference": "ORD-2026-10428"
}'{
"success": true,
"data": {
"id": "01JQ8VXKP3R2M4N5Q6S7T8U9V0",
"store_id": "01JQ8V0STORE00000000000001",
"title": "WINMAX Order #10428",
"amount": 1290,
"currency": "THB",
"slug": "wm10428",
"status": "active",
"channels_enabled": [
"promptpay",
"visa",
"mastercard"
],
"max_uses": null,
"used_count": 0,
"reference": "ORD-2026-10428",
"expires_at": "2026-10-15T09:12:44.000Z",
"items": [],
"item_summary": null,
"pay_url": "https://paydy.ai/pay/wm10428",
"created_at": "2026-10-14T09:12:44.000Z"
}
}ไม่มีค่า API call ไม่มีค่าขั้นต่ำรายเดือน
ค่าธรรมเนียมของคุณ
1.95%
เริ่มต้น (MDR ตามแพ็กเกจ) ต่อรายการที่สำเร็จ · API และ webhook ฟรี
เลือกภาษาที่ทีมถนัด แล้วให้ PAYDY จัดการ routing ไปยัง partner ที่ดีที่สุดให้
รายละเอียดทั้งหมดอยู่ใน API reference
ไม่ต้อง ถ้าคุณใช้ hosted checkout หรือ tokenization ของเรา ข้อมูลบัตรจะไม่วิ่งผ่านเซิร์ฟเวอร์คุณเลย ทำให้เหลือเพียงแบบประเมินตนเอง SAQ-A เท่านั้น หากต้องการรับเลขบัตรบนระบบของคุณเองจะต้องผ่าน PCI-DSS SAQ-D ซึ่งเราช่วยเตรียมเอกสารให้
ค่าเริ่มต้นคือ 100 คำขอต่อ 60 วินาทีต่อคีย์ ส่วน endpoint สร้างรายการจำกัดที่ 10 ครั้งต่อ 60 วินาที ทุก response มี header บอกโควตาคงเหลือและเวลารีเซ็ต ขอเพิ่มได้ผ่านทีมซัพพอร์ตโดยแนบปริมาณที่คาดไว้
เราส่ง header X-Paydy-Signature เป็น HMAC SHA-256 ของ raw body รวมกับ timestamp โดยใช้ webhook secret ของคุณเป็นคีย์ ให้คำนวณจาก raw body ก่อน parse JSON และปฏิเสธ request ที่ timestamp ห่างเกิน 5 นาทีเพื่อกัน replay
เราจะ retry สูงสุด 5 ครั้งด้วย exponential backoff จาก 1 นาทีถึง 12 ชั่วโมง ทุก event ยังเก็บอยู่ใน event log ให้กด replay ย้อนหลังได้เอง และดึงสถานะล่าสุดได้ตลอดด้วย GET /v1/charges/:id
โครงสร้าง request/response เหมือนกันทั้งหมด ต่างกันที่ไม่มีเงินจริงเคลื่อนไหว คุณใช้บัตรทดสอบเพื่อสั่งให้เกิดสถานะ succeeded, failed หรือ 3DS challenge ได้ตามต้องการ และยิง webhook จำลองจากหลังบ้านได้ไม่จำกัด
รองรับ 3DS 2.x เต็มรูปแบบ ระบบจะคืน redirect URL มาให้เมื่อธนาคารผู้ออกบัตรต้องการยืนยันตัวตนเพิ่ม และคืนผลลัพธ์ผ่าน webhook ตามปกติ คุณตั้งนโยบายได้ว่าให้บังคับ 3DS ทุกรายการหรือเฉพาะรายการความเสี่ยงสูง
test key ออกให้ทันทีหลังสมัคร ไม่ต้องคุยกับเซลส์ก่อน
ทุก payload มี header ลายเซ็นและ timestamp ตรวจได้ 3 บรรทัด กัน replay attack
ส่ง Idempotency-Key แล้วยิงซ้ำได้เท่าที่ต้องการ ไม่มีรายการซ้อน ไม่มีเงินหาย
บัตรทดสอบ สถานะ fail ที่สั่งได้ และ webhook จำลอง ยิงทดสอบไม่จำกัดและไม่มีค่าใช้จ่าย
แบ่งเงินได้ถึง 50 บัญชีในคำสั่งเดียว กำหนดแบบจำนวนเงินหรือเปอร์เซ็นต์ก็ได้
ทุก response บอกโควตาคงเหลือใน header ขอเพิ่มลิมิตได้ตามปริมาณจริงของธุรกิจ
ดู latency และ error rate ต่อ endpoint ย้อนหลัง 30 วัน พร้อม webhook แจ้งเตือนเหตุการณ์
ขั้นที่ 3
ตั้ง endpoint ของคุณ ทดสอบ replay event ได้จากหลังบ้านโดยไม่ต้องสร้างรายการใหม่
X-Paydy-Signature
ขั้นที่ 4
ยืนยันตัวตนร้านค้าเสร็จ เปลี่ยนคีย์เดียวแล้วเริ่มรับเงินจริงได้เลย
epk_live_…