อัปโหลดสลิป
หากการชำระเงินไม่ปรากฏในระบบโดยอัตโนมัติ ระบบจะอนุญาตให้อัปโหลดสลิปเพื่อตรวจสอบการชำระเงิน ร้านค้าสามารถใช้ API endpoint นี้เพื่ออัปโหลดสลิปการชำระเงินได้ทันทีในขณะที่คำสั่งซื้อยังเปิดอยู่ โดยไม่ต้องรอ
เงื่อนไขในการอัปโหลดสลิปมีดังนี้:
- สถานะของคำสั่งซื้อต้องเป็น "pending"
- รูปภาพที่อัปโหลดต้องเป็นรูปแบบ JPEG หรือ PNG และขนาดไม่เกิน 1 MB
URL : /slip/upload
Method : POST
ข้อกำหนดข้อมูล
{
"merchant_id" : "[Merchant id]",
"token" : "[Auth Token]",
"time" : "[Time Stamp]",
"platform_order_id" : "[platform order id]",
"image_base64" : "[slip image in base64 format]"
}
คำอธิบาย
| ชื่อพารามิเตอร์ | คำอธิบาย | ตัวอย่าง |
|---|---|---|
| platform_order_id | รหัสคำสั่งซื้อของแพลตฟอร์ม | THBP20240401071230HW2xxxxx |
| image_base64 | รูปภาพในรูปแบบ base64 รองรับไฟล์: jpg, png ขนาดไฟล์สูงสุด 1 MB | /9j/4AAQSkZJRgABAQAASABIAAD/4VeGRXhpZgAATU0AK...... |
ตัวอย่างข้อมูล
{
"merchant_id": "AA12345678",
"token": "testtokentesttokentesttokentesttokentesttoken",
"time": 1656272222,
"platform_order_id" : "THBP20240401071230HW2xxxxx",
"image_base64" : "/9j/4AAQSkZJRgABAQAASABIAAD/4VeGRXhpZgAATU0AK....."
}
Response
พารามิเตอร์ใน response มีดังนี้
| พารามิเตอร์ | คำอธิบาย |
|---|---|
| msg | จะเป็น 'slip upload successful.' เสมอ |
| verification_msg | ข้อความตรวจสอบเบื้องต้นจาก QR Code ในสลิป |
Response สำเร็จ
Code : 200 OK
ตัวอย่างข้อมูล
{
"success": 200,
"data": {
"msg": "slip upload successful.",
"verification_msg": "amount ok, destination ok, transfer in time.",
}
}
Response ข้อผิดพลาด
เงื่อนไข : กรณี merchant id, token หรือ signature ไม่ถูกต้อง
Code : 403 BAD REQUEST
ข้อมูล :
{
"error": {
"code": 403,
"message": "authentication failed"
}
}
เงื่อนไข : กรณีเกิดข้อผิดพลาดอื่นๆ
Code : 500 ERROR
ข้อมูล :
{
"error": {
"code": 500,
"message": "platform_order_id not found"
}
}