Sandbox

#การทดสอบด้วย Sandbox

#Sandbox ทำงานอย่างไร

Sandbox เกิดจากสองอย่างประกอบกัน คือ บัญชีร้านค้าแบบ sandbox และ โฮสต์ sandbox:

• เรียกไปที่ https://sandbox-api.<domain>/v1/… (ปัจจุบันคือ https://sandbox-api.paymenow.asia)
• ใช้ข้อมูลยืนยันตัวตนของ sandbox (pk_demo_… / sk_demo_…)

รายการใน sandbox ถูกเก็บในตารางแยกต่างหาก ไม่เคยถูกส่งถึงผู้ให้บริการชำระเงินจริง และคืน payload ของ QR แบบจำลอง (ไม่มี qr_code_image) ส่วนการเข้าและตัดยอดคงเหลือ ทำงานเหมือนจริง การถอนใน sandbox จึงยังต้องมียอดคงเหลือใน sandbox ด้วย

ติดต่อฝ่ายสนับสนุนเพื่อขอข้อมูลยืนยันตัวตนของ sandbox

#จำนวนเงินสำหรับทดสอบ

ใน sandbox จำนวนเงินบางค่าจะให้ผลลัพธ์ที่กำหนดไว้ตายตัว:

ตัวช่วย /sandbox/test-amounts ยังแสดง 888.88 ว่าเป็นตัวกระตุ้น timeout อยู่ แต่ความจริงยังไม่ได้ทำไว้ ค่า 888.88 ทำงานเหมือนจำนวนเงินอื่นทุกประการ ให้ใช้ header X-Sandbox-Scenario: timeout แทน

อย่าลืมว่าขั้นต่ำเด็ดขาด (รับเงิน 50 บาท จ่ายเงินออก 100 บาท) มีผลใน sandbox ด้วย ค่า 100.00 จึงเป็นยอดทดสอบการรับเงินที่น้อยที่สุดที่ใช้ได้จริง

#สถานการณ์ทดสอบ

สั่งผลลัพธ์ที่ต้องการได้ด้วย header X-Sandbox-Scenario ซึ่งมีผลเหนือกว่าการกำหนดด้วยจำนวนเงิน และจะถูกละเว้นสำหรับร้านค้าแบบ production

เมื่อรายการรับเงินใน sandbox เข้าสู่ completed หรือ failed ทันทีและคุณส่ง webhook_url มาด้วย ระบบจะยิง webhook เหมือนกับใน production ตัวรับ webhook ของคุณจึงทดสอบได้ครบวงจร

ตัวอย่าง:

curl -X POST https://sandbox-api.paymenow.asia/v1/payments/deposit \
  -H "X-Sandbox-Scenario: auto_approve" \
  -H "X-API-Key: your_sandbox_api_key" \
  -H "X-Signature: ..." \
  -H "X-Timestamp: ..." \
  -H "Content-Type: application/json" \
  -d '{"amount": 500.00, "currency": "THB", "reference_id": "TEST-001", "bank_code": "004", "bank_account_no": "1234567890", "bank_account_name": "Test Payer"}'

#endpoint ตัวช่วยของ sandbox

ให้บริการเฉพาะบนโฮสต์ sandbox และ ไม่ต้องยืนยันตัวตน:

จำกัดที่ 300 คำขอต่อนาทีต่อหนึ่ง IP ที่ชั้นเกตเวย์

#Header ใน Response