ข้ามไปยังเนื้อหาหลัก

ทดสอบฟรี ไม่ต้องสมัคร

ศูนย์นักพัฒนาที่เริ่มใช้ได้เลยตอนนี้

มี sandbox key ใช้ร่วมกัน คอนโซลที่ตอบกลับด้วยโครงสร้างผลลัพธ์จริง และตัวอย่างโค้ดที่สร้างจากแคตาล็อกชุดเดียวกับคู่มือ API — สิ่งที่คุณคัดลอกจากหน้านี้จึงไม่เคยล้าสมัย

  • ไม่ต้องมีบัญชี ไม่ต้อง KYC ไม่ต้องใช้บัตร
  • โครงสร้างผลลัพธ์ สถานะ และ header เหมือนของจริง
  • สนาม webhook ที่คำนวณลายเซ็น HMAC สด ๆ
  • ตัวอย่างโค้ดห้าภาษา คัดลอกไปใช้ได้ทันที

ข้อมูลเชื่อมต่อ Sandbox

shell
# Base URL ของ Sandbox
export PAYDY_BASE_URL="https://api-sandbox.paydy.ai/v1"

# คีย์ทดสอบของคุณ
export PAYDY_API_KEY="epk_test_YOUR_TEST_KEY"
สร้างคีย์ทดสอบepk_test_…

คีย์ทดสอบ (epk_test_…) ใช้ได้เฉพาะกับ sandbox และไม่มีการโอนเงินจริง คีย์ใช้งานจริง (epk_live_…) ใช้ได้เฉพาะ production เก็บคีย์ทั้งสองไว้ฝั่งเซิร์ฟเวอร์เท่านั้น

สองนาที

เริ่มต้นเร็ว

ตั้งค่า base URL และคีย์ทดสอบสองตัวแปรนี้ แล้วเรียกครั้งแรกได้เลย สร้างคีย์ทดสอบ (epk_test_…) ได้ในคอนโซลที่เมนู API keys — ไม่มีคีย์ตัวอย่างที่ใช้ร่วมกัน
cURL
curl -X POST https://api-sandbox.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"
     }'
Base URL ของ Sandbox
https://api-sandbox.paydy.ai/v1
Base URL ของ Production
https://api.paydy.ai/v1
การยืนยันตัวตน
Authorization: Bearer epk_test_…
โครงสร้างผลลัพธ์
{ success, data, meta?, error? }

กดลองได้

คอนโซล API

เลือก endpoint แก้ไข JSON ของคำขอ แล้วกดส่ง คอนโซลจะตรวจความถูกต้องของ body ทำงานกับแคช replay ของ Idempotency-Key และคืนรหัสสถานะ เวลาตอบสนอง และ header แบบเดียวกับ API จริง

เอนด์พอยต์

POST/merchant/payment-linksIdempotentowner · manager

สร้างลิงก์ชำระเงินของร้านหนึ่งของคุณ และคืนลิงก์พร้อม URL หน้า checkout (pay_url) เลือกช่องทางชำระ จำกัดจำนวนครั้งและวันหมดอายุได้ และใส่รายการสินค้าได้สูงสุด 100 รายการ

คำขอ

บรรทัดคำขอและ header
POST https://api-sandbox.paydy.ai/v1/merchant/payment-links
Authorization: Bearer epk_test_YOUR_TEST_KEY
Content-Type: application/json
Idempotency-Key: idem_demo_0001

ต้องเป็น JSON ที่ถูกต้อง ลองลบฟิลด์ที่จำเป็นออกเพื่อดูผลลัพธ์ 400

^[a-zA-Z0-9_\-:]{8,64}$

ส่งคีย์เดิมสองครั้ง คำขอที่สองจะถูกตอบจากแคช replay อายุ 24 ชั่วโมง ไม่ตัดเงินซ้ำ

ผลลัพธ์

เหลือ 100/100 ในช่วงเวลานี้

ยังไม่มีผลลัพธ์

แก้ body ด้านซ้ายได้ตามต้องการ แล้วกด “ส่งคำขอ” เพื่อดูสถานะ เวลาตอบสนอง และ header

พารามิเตอร์

POST /merchant/payment-links — พารามิเตอร์
ชื่อตำแหน่งชนิดจำเป็นคำอธิบาย
store_idbodystringจำเป็นYour store the link belongs to (ULID).
titlebodystringจำเป็นShown to the payer. 2–255 chars.
amountbodynumberจำเป็นBaht, up to 2 decimals. 1 – 99,999,999. With items, must equal their sum.
channels_enabledbodystring[]จำเป็นAt least one of: promptpay, visa, mastercard, jcb, amex, truemoney, linepay, installment, crypto, transfer.
currencybodystringไม่บังคับISO 4217, max 3 chars. Default THB.
descriptionbodystringไม่บังคับLonger text on the checkout page.
itemsbodyobject[]ไม่บังคับUp to 100 lines of { name, quantity, unit_price, product_id?, sku?, image_url? }.
max_usesbodyintegerไม่บังคับSuccessful payments allowed before the link closes. Omit for unlimited.
expires_in_hoursbodyintegerไม่บังคับ1–8760. Or send expires_at (ISO 8601).
return_urlbodystringไม่บังคับWhere the payer goes after paying.
referencebodystringไม่บังคับYour own order id, max 255 chars.

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

cURL
curl -X POST https://api-sandbox.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"
     }'

ข้อมูลตัวอย่าง

ข้อมูลทดสอบ

ค่าเหล่านี้มีอยู่แค่ใน sandbox แต่ละค่าบังคับให้ได้ผลลัพธ์แบบเจาะจง คุณจึงเขียนเส้นทางที่ไม่สวยงามได้ก่อนรับเงินจริงแม้แต่บาทเดียว

ใช้ได้เฉพาะ Sandbox

บัตร เลขอ้างอิง และเลขบัตรประชาชนเหล่านี้ใช้กับ production ไม่ได้ และไม่มีการโอนเงินจริง ห้ามฝังไว้ในโค้ดฝั่งผู้ใช้

บัตรทดสอบ

บัตรทดสอบ
เลขบัตรแบรนด์ผลลัพธ์failure_code
4242 4242 4242 4242
VISAอนุมัติ—
5555 5555 5555 4444
Mastercardอนุมัติ—
4000 0000 0000 0002
VISAถูกปฏิเสธcard_declined
4000 0000 0000 9995
VISAวงเงินไม่พอinsufficient_funds
4000 0000 0000 3220
VISAต้องทำ 3-D Secure—
4100 0000 0000 0019
VISAถูก Fraud Shield บล็อกblocked_by_fraud_shield

ใช้วันหมดอายุในอนาคตและ CVV สามหลักอะไรก็ได้ ผลลัพธ์ขึ้นกับเลขบัตรเท่านั้น

โฟลว์ PromptPay ทดสอบ

  • PP-SANDBOX-PAIDสแกน QR แล้วจ่ายครบภายในราวสามวินาที
  • PP-SANDBOX-PENDINGQR ยังไม่ถูกจ่าย เพื่อให้ทดสอบหน้าจอรอชำระ
  • PP-SANDBOX-EXPIREDQR หมดอายุโดยไม่มีการจ่าย และยิง payment.failed
  • PP-SANDBOX-UNDERPAIDลูกค้าจ่ายน้อยกว่ายอดที่ต้องชำระ ใช้ทดสอบการจัดการยอดขาด

ตัวตนทดสอบ BNPL

  • 1-1011-11111-11-1คะแนน 712฿20,000

    ผ่านทุกการตรวจ ได้วงเงินหมุนเวียนทันที

  • 1-2022-22222-22-2คะแนน 648฿5,000

    ประวัติเครดิตบาง — อนุมัติด้วยวงเงินที่ลดลง

  • 1-3033-33333-33-3คะแนน 601—

    คะแนนก้ำกึ่ง — ส่งให้เจ้าหน้าที่พิจารณา

  • 1-4044-44444-44-4คะแนน 512—

    คะแนนบูโรต่ำกว่านโยบาย — ปฏิเสธคำขอ

KYC ใน sandbox ไม่ได้เรียก DOPA หรือ NCB จริง ผลลัพธ์ขึ้นกับตัวตนที่คุณเลือก

สนามทดลอง

สนาม Webhook

เลือกอีเวนต์ ชี้ไป endpoint ของคุณ แล้วกดส่ง ลายเซ็นที่แสดงด้านล่างคือ HMAC SHA-256 จริงของไบต์ payload นั้น คำนวณในเบราว์เซอร์ของคุณด้วยคีย์เดโมสาธารณะ จึงใช้ตรวจสอบโค้ดฝั่งคุณได้เลย อ่านคู่มือ webhook ฉบับเต็ม →

เลือกอีเวนต์

payment.success

เกตเวย์ยืนยันการชำระเงินแล้ว และรายละเอียดค่าธรรมเนียมสรุปแล้ว

transaction_idamountcurrencymethodfeecustomermetadata
คำขอที่ส่งไป
POST https://your-app.com/webhooks/paydy
Content-Type: application/json
PAYDY.ai-Event: payment.success
PAYDY.ai-Delivery: 01JQ8XJ1DELIVERY00000001
PAYDY.ai-Signature: …
Payload
{
  "id": "01JQ8XJ1DELIVERY00000001",
  "event": "payment.success",
  "created_at": "2026-10-14T09:14:02.000Z",
  "data": {
    "transaction_id": "01JQ8W4M3K1L2N5P6Q7R8S9T0U",
    "payment_link_id": "01JQ8VXKP3R2M4N5Q6S7T8U9V0",
    "amount": 129000,
    "currency": "THB",
    "method": "promptpay",
    "fee": {
      "mdr_amount": 1935,
      "vat": 135,
      "net_amount": 126930
    },
    "customer": {
      "email": "somchai@example.com",
      "name": "สมชาย ใจดี"
    },
    "metadata": {
      "order_id": "ORD-2026-10428"
    }
  }
}

ต้องเป็น HTTPS และตอบกลับภายใน 10 วินาที

เบราว์เซอร์ POST ไป URL ของบุคคลที่สามโดยตรงไม่ได้ ลำดับด้านล่างจึงจำลองตัวส่งจริงของระบบ หากต้องการยิงเข้า endpoint ของคุณจริง ให้สั่ง replay จากหลังบ้าน

ความพยายามส่งRetry: 1m → 5m → 30m → 2h → 12h

ยังไม่มีการส่ง

ลายเซ็นสดของ payload นี้

HMAC SHA-256 (hex) คำนวณจากไบต์ของ payload ตรง ๆ โดยใช้คีย์เดโมสาธารณะ whsec_sandbox_paydy_demo_2026 คีย์ของคุณเองจะแสดงครั้งเดียวตอนสร้าง endpoint

PAYDY.ai-Signature
…

ตรวจสอบลายเซ็น

Node.js / Express
import crypto from 'node:crypto';
import express from 'express';

const app = express();

// IMPORTANT: verify against the RAW body bytes, never the parsed JSON.
app.post(
  '/webhooks/paydy',
  express.raw({ type: 'application/json' }),
  (req, res) => {
    const received = req.header('PAYDY.ai-Signature') ?? '';
    const expected = crypto
      .createHmac('sha256', process.env.PAYDY_WEBHOOK_SECRET)
      .update(req.body)
      .digest('hex');

    const ok =
      received.length === expected.length &&
      crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));

    if (!ok) return res.status(401).json({ error: 'bad_signature' });

    const evt = JSON.parse(req.body.toString('utf8'));
    // Deliveries can repeat — key your handler on evt.id.
    switch (evt.event) {
      case 'payment.success':
        void fulfilOrder(evt.data.metadata.order_id);
        break;
      case 'refund.completed':
        void reverseOrder(evt.data.transaction_id);
        break;
    }

    res.status(200).json({ received: true });
  },
);

ไม่ต้องติดตั้งไลบรารี

เรียกด้วย HTTP

marketing.sandbox.http.intro

PAYDY ไม่มีไลบรารีสำหรับเรียก API

ไม่มีแพ็กเกจ SDK ให้ติดตั้ง ตัวอย่างในหน้านี้ใช้เฉพาะไลบรารีมาตรฐานของแต่ละภาษา ได้แก่ cURL, fetch ของ Node.js, ext-curl ของ PHP, urllib ของ Python และ net/http ของ Go เรียก API ด้วย HTTP →

อ้างอิง

รหัสข้อผิดพลาด

ความผิดพลาดทุกแบบใช้โครงสร้างเดียวกัน ตัวจัดการข้อผิดพลาดชุดเดียวจึงครอบคลุมทั้ง API · error.code คือประเภทตามรหัส HTTP ส่วน error.details.code (ถ้ามี) บอกสาเหตุที่แน่ชัด ให้แยกกรณีด้วยสองค่านี้ อย่าแยกด้วยข้อความ · ตารางนี้แสดงเฉพาะรหัสที่ API ส่งจริง
โครงสร้างข้อผิดพลาด
{
  "success": false,
  "data": null,
  "error": {
    "code": "FORBIDDEN",
    "message": "API_KEY_SCOPE_MISSING",
    "details": { "code": "API_KEY_SCOPE_MISSING", "message": "API_KEY_SCOPE_MISSING" }
  },
  "meta": { "path": "/v1/merchant/transactions/01JC8F2K9QW5R7T3M6N4P8V2XA/refund", "timestamp": "2026-11-08T09:30:00.000Z" }
}
รหัสข้อผิดพลาด
HTTPรหัสฟิลด์หมายความว่าอะไรแก้อย่างไร
400BAD_REQUESTerror.codeคำขอผิดรูปแบบ หรือมีฟิลด์ที่ไม่ผ่านการตรวจ error.message จะระบุกฎที่ไม่ผ่านทุกข้อแก้ฟิลด์ตามที่ error.message ระบุ แล้วส่งใหม่
401UNAUTHORIZEDerror.codeไม่มีข้อมูลยืนยันตัวตนที่ใช้ได้ เช่น ไม่มี header Authorization หรือคีย์หรือเซสชันใช้ไม่ได้อ่าน error.details.code เพื่อดูสาเหตุที่แน่ชัด (แถว API_KEY_… ด้านล่าง)
403FORBIDDENerror.codeข้อมูลยืนยันตัวตนถูกต้อง แต่ไม่มีสิทธิ์ทำสิ่งนี้ เช่น คีย์ไม่มี scope ที่ต้องใช้ ผูกกับร้านอื่น หรือบทบาทในทีมของคุณเรียก route นี้ไม่ได้อ่าน error.details.code · ถ้าเป็นเรื่องบทบาท ให้เจ้าของบัญชีเปลี่ยนให้ในหน้าตั้งค่าทีม
404NOT_FOUNDerror.codeไม่มี id นี้ หรือเป็นของร้านอื่นตรวจ ULID และยืนยันว่าเรียกในสภาพแวดล้อมเดียวกับที่สร้างมัน
409CONFLICTerror.codeทรัพยากรอยู่ในสถานะที่ทำคำสั่งนี้ไม่ได้ หรือเป็นคำขอซ้ำกับที่ทำไปแล้วอ่าน error.details.code ดึงข้อมูลทรัพยากร แล้วทำต่อตามสถานะปัจจุบัน
410GONEerror.codeendpoint หรือทรัพยากรนี้ถูกยกเลิกแล้วและจะไม่กลับมาใช้ทางแทนที่ error.message ระบุ
422VALIDATION_ERRORerror.codeคำขอรูปแบบถูกต้อง แต่ API ประมวลผลตามที่ส่งมาไม่ได้อ่าน error.message และ error.details ว่าต้องแก้อะไร
429RATE_LIMITEDerror.codeIP หรือผู้ใช้ของคุณส่งคำขอเกินโควตาของช่วงเวลานั้นหยุดรอพร้อมสุ่มระยะเวลา (jitter) แล้วลองใหม่
500INTERNAL_ERRORerror.codeเกิดข้อผิดพลาดฝั่งเรา · รหัส HTTP อื่นที่ไม่อยู่ในตารางนี้ก็ได้ INTERNAL_ERROR เช่นกันลองใหม่ด้วย Idempotency-Key เดิมแบบ exponential backoff และแจ้ง meta.path กับ meta.timestamp ให้ฝ่ายสนับสนุน
503SERVICE_UNAVAILABLEerror.codeสิ่งที่คำขอต้องใช้ยังไม่ได้ตั้งค่าหรือใช้งานไม่ได้ เช่น การส่ง SMS หรือพาร์ทเนอร์ชำระเงินอ่าน error.details.code แล้วลองใหม่ภายหลัง หรือให้เจ้าของบัญชีตั้งค่าส่วนที่ระบุให้เสร็จ
400IDEMPOTENCY_KEY_INVALIDerror.codeIdempotency-Key ไม่ได้อยู่ในรูป 8–64 ตัวอักษรของ [a-zA-Z0-9_-:]สร้างคีย์จาก ULID หรือ UUID โดยไม่มีวงเล็บหรือช่องว่าง
409IDEMPOTENCY_KEY_REUSEDerror.codeIdempotency-Key นี้เคยใช้กับเนื้อหาคำขอที่ต่างออกไปแล้วคำขอใหม่ให้ใช้คีย์ใหม่ · ถ้าส่งเนื้อหาเดิมทุกตัวอักษร จะได้คำตอบเดิมกลับมา
409IDEMPOTENCY_KEY_IN_FLIGHTerror.codeคำขอเดียวกันที่ใช้คีย์นี้ยังประมวลผลไม่เสร็จรอสักครู่ แล้วลองใหม่ด้วยคีย์เดิม
401API_KEY_INVALIDerror.details.codeค่า bearer ไม่ใช่คีย์ของ PAYDY (epk_test_… หรือ epk_live_…) หรือไม่ตรงกับคีย์ใดเลยคัดลอกคีย์ทั้งหมดใหม่ — คีย์แสดงเพียงครั้งเดียวตอนสร้าง
401API_KEY_REVOKEDerror.details.codeคีย์ถูกยกเลิกแล้ว โดยทีมของคุณ หรือโดย PAYDY เพราะเป็นคีย์ที่สร้างก่อนระบบมี scope และไม่เคยใช้งานได้สร้างคีย์ใหม่พร้อม scope ที่ต้องใช้
401API_KEY_EXPIREDerror.details.codeคีย์เลยวันหมดอายุแล้วสร้างคีย์ใหม่ คีย์ที่หมดอายุไม่ถูกเปิดใช้ซ้ำ
401API_KEY_UNVERIFIABLEerror.details.codeระบบนี้ตรวจคีย์ไม่ได้ในขณะนี้ลองใหม่ภายหลัง ถ้ายังเป็นอยู่ ให้ติดต่อฝ่ายสนับสนุนพร้อม meta.path และ meta.timestamp
401API_KEY_NOT_ACCEPTED_HEREerror.details.coderoute นี้ไม่รับ API key · รับเฉพาะ route ที่อยู่ในเอกสารนี้เรียก route ที่มีในเอกสาร หรือทำรายการนี้จากแดชบอร์ด
403MERCHANT_SUSPENDEDerror.details.codeบัญชีร้านค้าถูกระงับติดต่อฝ่ายสนับสนุนของ PAYDY
403API_KEY_MODE_MISMATCHerror.details.codeส่งคีย์ทดสอบไปที่ระบบจริง หรือส่งคีย์จริงไปที่ Sandboxส่งคีย์ epk_test_… ไปที่ api-sandbox.paydy.ai และคีย์ epk_live_… ไปที่ api.paydy.ai
403API_KEY_GATEWAY_MODE_MISMATCHerror.details.codeโหมดของคีย์ไม่ตรงกับเกตเวย์ชำระเงินที่เปิดใช้อยู่ในระบบนี้ติดต่อฝ่ายสนับสนุน เกตเวย์ของระบบนี้ต้องตั้งเป็นโหมดเดียวกัน
403API_KEY_SCOPE_MISSINGerror.details.codeคีย์ไม่มี scope ที่ route นี้ต้องใช้สร้างคีย์ที่มี scope นั้น — แต่ละ endpoint แสดง scope ที่ต้องใช้ไว้
403API_KEY_STORE_BOUNDerror.details.codeใช้คีย์ที่ผูกกับร้านเดียว เรียก route ที่ทำงานกับทั้งบัญชีร้านค้าใช้คีย์แบบทั้งบัญชีสำหรับ route นี้
403API_KEY_STORE_MISMATCHerror.details.codeคีย์ที่ผูกกับร้านหนึ่ง อ้างถึงข้อมูลของร้านอื่นใช้คีย์ของร้านนั้น หรือคีย์แบบทั้งบัญชี
403API_KEY_CREATOR_INACTIVEerror.details.codeสมาชิกทีมที่สร้างคีย์นี้ไม่ได้เป็นเจ้าของหรือผู้จัดการที่ยังใช้งานอยู่แล้วสร้างคีย์ใหม่ขณะเข้าสู่ระบบด้วยบัญชีเจ้าของหรือผู้จัดการที่ยังใช้งานอยู่
429RATE_LIMIT_EXCEEDEDerror.details.codeคีย์นี้ส่งคำขอเกินโควตาของช่วงเวลานั้นรอตามจำนวนวินาทีใน header Retry-After แล้วลองใหม่พร้อมสุ่มระยะเวลา
409AMOUNT_MISMATCHerror.details.codeยอดที่ส่งมาไม่ตรงกับยอดที่รายการนี้แบ่งได้ คือยอดสุทธิหักเงินคืนที่ยืนยันแล้วไม่ต้องส่ง amount หรือส่งค่าตาม error.details.expected_amount
409REFUND_IN_PROGRESSerror.details.codeรายการนี้มีการคืนเงินที่รอดำเนินการอยู่ หรือมีการคืนเงินบางส่วนจากคำสั่งซื้อแล้วคืนเงินส่วนที่เหลือจากคำสั่งซื้อ หรือรอให้การคืนเงินที่ค้างอยู่เสร็จก่อน
409REFUND_EXCEEDS_AMOUNTerror.details.codeยอดคืนเงินมากกว่ายอดที่ยังคืนได้ของรายการนี้คืนเงินได้ไม่เกินยอดคงเหลือที่ error.message ระบุ
400WEBHOOK_URL_NOT_ALLOWEDerror.details.codeURL ของ webhook ชี้ไปยังที่อยู่ภายในหรือเครือข่ายส่วนตัวใช้ URL แบบ HTTPS ที่เข้าถึงได้สาธารณะ error.details.reason บอกเหตุผลที่ถูกปฏิเสธ
409PAYMENT_ALREADY_PAIDerror.details.codeรายการนี้ได้รับเงินแล้ว จึงยกเลิกไม่ได้ error.details มี intent_id และ statusห้ามทิ้งรายการนี้ ให้ส่งมอบสินค้า หรือคืนเงินผ่าน POST /v1/platform/payments/:id/refund
409PAYMENT_IN_PROGRESSerror.details.codeพาร์ตเนอร์กำลังดำเนินการชำระเงินนี้อยู่ หรือ PAYDY กันรายการไว้ตรวจสอบ จึงยังยกเลิกไม่ได้ยังไม่ต้องทำอะไร รอ webhook payment.paid, payment.failed หรือ payment.expired บอกผล
409PAYMENT_DISPUTEDerror.details.codeรายการนี้มีข้อพิพาทหรือการเรียกเงินคืน (chargeback) ที่ยังเปิดอยู่ จึงยังคืนเงินไม่ได้ error.details มี intent_id และ dispute_idรอ webhook payment.dispute_closed ถ้าแพ้ข้อพิพาท PAYDY จะบันทึกเงินที่ออกไปเป็นการคืนเงินและส่ง payment.refunded (reason chargeback)

การใช้งานจริง

ลิมิต & Idempotency

สองกฎที่ตัดสินว่าการเชื่อมต่อของคุณจะรอดในวันที่เน็ตแย่หรือไม่ — เรียกได้บ่อยแค่ไหน และจะเกิดอะไรขึ้นถ้าเรียกซ้ำ

ลิมิตการเรียก

100 คำขอต่อ 60 วินาที ต่อหนึ่ง API key ส่วน endpoint ยืนยันตัวตนเข้มกว่าที่ 5 ครั้งในช่วงเวลาเดียวกัน เพื่อสกัดการสุ่มรหัส

Endpoint ทั่วไป
100 / 60s
Endpoint ยืนยันตัวตน
5 / 60s
Header ที่มาทุกผลลัพธ์
X-RateLimit-LimitX-RateLimit-RemainingRetry-After

เมื่อได้ 429 ให้รอตามวินาทีใน Retry-After และบวก jitter เล็กน้อย การลองใหม่ทันทีจะเผาโควตาของช่วงถัดไปไปด้วย

การกันเรียกซ้ำ (Idempotency)

ส่ง Idempotency-Key ทุกครั้งที่ POST แล้วมีการเคลื่อนเงิน คีย์ต้องยาว 8–64 ตัวอักษร ผลลัพธ์ครั้งแรกถูกแคชไว้ 24 ชั่วโมง การส่งซ้ำจะได้ผลลัพธ์เดิมกลับไป ไม่ตัดเงินใหม่

Idempotency-Key
Idempotency-Key: idem_order_10428_attempt1

# pattern  ^[a-zA-Z0-9_\-:]{8,64}$
# ttl      24h (Redis)
# replay   X-Idempotent-Replay: true
  • แคชผูกกับเส้นทางบวกกับคีย์ คีย์เดิมที่ยิงต่าง endpoint จึงถือเป็นคำขอใหม่
  • ผลลัพธ์ที่มาจากแคชจะมี X-Idempotent-Replay: true ให้แยกแยะได้
  • ผลลัพธ์ 5xx ไม่ถูกแคช ความผิดพลาดฝั่งเซิร์ฟเวอร์จึงลองใหม่ด้วยคีย์เดิมได้เสมอ

เช็กลิสต์

เช็กลิสต์ก่อนขึ้นจริง

แปดข้อที่ต้องเช็กให้ครบ ระหว่างการเชื่อมต่อใน sandbox ที่ใช้ได้ กับการรับเงินจริง แต่ละข้อใช้เวลาไม่นาน แต่การข้ามไปนั้นแพง
  1. 1

    ทำ KYC ร้านค้าให้เสร็จ

    อัปโหลดเอกสารบริษัทและบัญชีธนาคาร ระบบจะโอนเงินได้หลังผ่านขั้นนี้

  2. 2

    เปลี่ยนไปใช้คีย์จริง

    ย้ายคีย์ epk_live_… ไปไว้ใน secret manager ห้ามให้หลุดไปโค้ดฝั่งผู้ใช้หรือ git

  3. 3

    ลงทะเบียนและตรวจลายเซ็น webhook

    ชี้ production ไป endpoint HTTPS ที่ตรวจลายเซ็นและตอบกลับใน 10 วินาที

  4. 4

    ส่ง Idempotency key

    ทุก POST ที่เคลื่อนเงินต้องมี สร้างต่อหนึ่งความพยายาม และใช้ซ้ำเมื่อ retry

  5. 5

    จัดการเส้นทางที่ผิดพลาด

    ทดสอบการปฏิเสธ วงเงินไม่พอ 3-D Secure และการกันไว้ตรวจทุจริต ด้วยบัตรทดสอบด้านบน

  6. 6

    ต่อระบบคืนเงิน

    ให้พนักงานคืนเงินได้โดยไม่ต้องพึ่งนักพัฒนา และบัญชีของคุณต้องสะท้อนการคืนบางส่วน

  7. 7

    กระทบยอด settlement จริงหนึ่งรอบ

    จับคู่ยอดรวม MDR VAT และยอดสุทธิกับ statement ธนาคาร ก่อนจะเพิ่มปริมาณ

  8. 8

    เฝ้าดูตอนขึ้นจริง

    ตั้งแจ้งเตือนเมื่อ webhook ล้มเหลว 4xx พุ่ง หรืออัตราการปฏิเสธเปลี่ยน — บันทึก x-request-id ทุกคำขอ

พร้อมเปิดใช้งานจริงแล้วหรือยัง?

รับ API key จริงและเริ่มเชื่อมต่อได้เลย — สมัครฟรี ไม่มีค่าติดตั้ง

แซนด์บ็อกซ์ API — PAYDY.ai · PAYDY.ai