Upload Bukti Pembayaran

API Upload Bukti Pembayaran wilayah Thailand. Digunakan ketika respons pay-in mengembalikan channel.uploadReceipt = 1. Pembayar harus mengirimkan gambar slip transfer bank atau QR Code sebagai bukti pembayaran.

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 yang dikembalikan dari respons pay-in.
qrCode	O	String	String QR Code yang dipindai dari slip pembayaran. Wajib mengisi qrCode atau imgBase64Data minimal salah satu.
imgBase64Data	O	String	Gambar bukti yang dikodekan Base64. Format yang didukung: JPEG, PNG, GIF, WEBP. Ukuran maks: 5 MB. Gunakan format data:image/{type};base64,{data}. Wajib mengisi qrCode atau imgBase64Data minimal salah satu.

---

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 berhasil; nilai lain menunjukkan upload gagal.
message	M	String	Pesan hasil dalam UTF-8.
responseCode	M	String	Kode gabungan: HTTP status + service code + case code (mis. 2007400).
responseMessage	M	String	Deskripsi hasil.
data	O	Object	Objek hasil upload, ada ketika code adalah 00.
success	O	Boolean	true jika upload berhasil.

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