อัปโหลดหลักฐานการชำระเงิน

API อัปโหลดหลักฐานการชำระเงิน ภูมิภาค ไทย ใช้เมื่อ Pay-in response คืนค่า channel.uploadReceipt = 1 ผู้ชำระเงินต้องส่งภาพสลิปการโอนเงินหรือรหัส QR เป็นหลักฐาน.

Request

POST/v2.0/upload-receipt

Request Path:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/upload-receipt
production: https://gateway.smilepayz.com/v2.0/upload-receipt

Header Parameters

Field	Required	Type	Description
Content-Type	M	String	application/json request body.
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	Signature of JSON body (see product Signature doc).
X-PARTNER-ID	M	String	Your merchantID

Body Parameters

Field	Required	Type	Description
tradeNo	M	String	Smilepayz tradeNo ที่ได้รับจาก Pay-in response.
qrCode	O	String	สตริง QR Code ที่สแกนจากสลิปการชำระเงิน. ต้องระบุ qrCode หรือ imgBase64Data อย่างน้อยหนึ่งรายการ.
imgBase64Data	O	String	ภาพหลักฐานที่เข้ารหัส Base64. รูปแบบที่รองรับ: JPEG, PNG, GIF, WEBP. ขนาดสูงสุด: 5 MB. ใช้รูปแบบ data:image/{type};base64,{data}. ต้องระบุ qrCode หรือ imgBase64Data อย่างน้อยหนึ่งรายการ.

---

Example Body:

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00
X-SIGNATURE: 7MHd9v5/m9JeqmDZVwWBZUZ5J5...7120QnFEny7Qm7uQR1G0TWCh10fsU6nVxiRoeoQ==
X-PARTNER-ID: 20011

{
    "tradeNo": "1112001125042408363186433",
    "imgBase64Data": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAIAAACQd1PeAAAADklEQVQI12P4z8BQDwADhQGAWjR9awAAAABJRU5ErkJggg=="
}

{
    "tradeNo": "1112001125042408363186433",
    "qrCode": "00020101021229370016A0000006770101110113006680870163353037645406299.985802TH63048436"
}

Responses

HTTP Response

Field	Required	Type	Description
Content-Type	M	String	application/json
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm

Body Parameters

Field	Required	Type	Description
code	M	String	00 อัปโหลดสำเร็จ; ค่าอื่นแสดงว่าอัปโหลดล้มเหลว.
message	M	String	ข้อความผลลัพธ์ UTF-8.
responseCode	M	String	รหัสรวม: HTTP status + service code + case code (เช่น 2007400).
responseMessage	M	String	คำอธิบายผลลัพธ์.
data	O	Object	ผลลัพธ์การอัปโหลด คืนค่าเมื่อ code เป็น 00.
success	O	Boolean	true หากอัปโหลดสำเร็จ.

Content-type: application/json
X-TIMESTAMP: 2020-12-17T10:55:00+07:00

{
    "code": "00",
    "message": "Successful",
    "responseCode": "2007400",
    "responseMessage": "Successful",
    "data": {
        "success": true
    }
}

{
    "code": "10",
    "message": "imgBase64Data must be a JPEG, PNG, GIF, or WEBP image",
    "responseCode": "4007400",
    "responseMessage": "imgBase64Data must be a JPEG, PNG, GIF, or WEBP image"
}