อัปโหลดสลิป

หากการชำระเงินไม่ปรากฏในระบบโดยอัตโนมัติ ระบบจะอนุญาตให้อัปโหลดสลิปเพื่อตรวจสอบการชำระเงิน ร้านค้าสามารถใช้ API endpoint นี้เพื่ออัปโหลดสลิปการชำระเงินได้ทันทีในขณะที่คำสั่งซื้อยังเปิดอยู่ โดยไม่ต้องรอ

เงื่อนไขในการอัปโหลดสลิปมีดังนี้:

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"
    }
}