Upload Payment Receipt

Thailand region Upload Payment Receipt API. Used when the response returns channel.uploadReceipt = 1. The payer must submit a bank transfer slip image or QR code as proof of payment.

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 returned by the pay-in response.
qrCode	O	String	QR code string scanned from the payment slip. Either qrCode or imgBase64Data must be provided.
imgBase64Data	O	String	Receipt image encoded as Base64. Accepted formats: JPEG, PNG, GIF, WEBP. Maximum size: 5 MB. Use data:image/{type};base64,{data} URI format. Either qrCode or imgBase64Data must be provided.

---

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 upload successful; other values indicate upload failure.
message	M	String	UTF-8 human-readable result line.
responseCode	M	String	Composite code: HTTP status + service code + case code (e.g. 2007400).
responseMessage	M	String	Human-readable response description.
data	O	Object	Upload result object. Present when code is 00.
success	O	Boolean	true if the receipt was uploaded successfully.

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