上传付款凭证

泰国地区上传付款凭证接口。当收款（Pay-in）响应中 channel.uploadReceipt = 1 时使用，付款人需提交银行转账回执图片或二维码内容作为付款证明。

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 请求体。
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm
X-SIGNATURE	M	String	请求体签名（见产品文档 签名生成）。
X-PARTNER-ID	M	String	Your merchantID

Body Parameters

Field	Required	Type	Description
tradeNo	M	String	收款接口返回的平台 tradeNo。
qrCode	O	String	从付款回执扫描的二维码字符串。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 状态 + 服务码 + 子码（如 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"
}