Merchant Payment Notification

Proses ini digunakan jika merchant ingin mengirimkan notifikasi pembayaran atas transaksi yang terdaftar di sistem Tagih.id namun tidak dibayarkan melalui Tagih.id. Merchant akan mengirimkan request ke sistem Tagih.id, lalu Tagih.id akan memberikan response dengan format json seperti contoh dibawah

Alur Pesan

Merchant -> Tagih.id

Metode

HTTP Post

API URL

Development : https://sandbox-api.espay.id/rest/tagih/merchantpaymentnotif

Production : https://api.espay.id/rest/tagih/merchantpaymentnotif


Parameter Request:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 64 Ya Request identifier. Id unik untuk mengidentifikasi pesan ini dengan pesan lainnya
rq_datetime 19 Ya Tanggal dan waktu di server aplikasi Tagih.id saat pesan terkirim
comm_code 32 Ya Kode merchant yang terdaftar pada aplikasi Tagih.id
member_code 20 Ya Kode member yang terdaftar pada aplikasi Tagih.id
signature 64 Ya Signature yang digenerate oleh merchant dan akan di validasi oleh Tagih.id, lihat halaman ini untuk detailnya
tx_id 32 Ya Nomor transaksi id unik untuk mengidentifikasi order/billing/invoice.
tx_date 19 Ya Tanggal dan waktu saat transaksi terjadi Format: yyyy-MM- dd hh:mm:ss
invoices JSON Ya Detail transaksi
Format: {invoice_no:amount}
Contoh: {INV001:
90000,INV002:50000}
bank 25 Tidak Nama Bank dimana customer membayar transaksi
payment_type 25 Tidak Cara customer membayar
Contoh: cash, VA, CC, dll

Parameter Response:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 4 Ya Request identifier. Id unik untuk mengindentifikasi pesan ini dan pesan lainnya
rs_datetime 32 Ya Tanggal dan waktu server Espay saat messages response
error_code 4 Ya Kode error web service, 0000 berarti success
error_message 32 Ya Deskripsi error
invoices JSON Tidak Detail Transaksi
Contoh: {"IN-DGI773246": "Success"}
total_invoice 5 Tidak Total Invoice yang dikirim
total_success 5 Tidak Total Invoice yang berhasil diproses
total_error 5 Tidak Total Invoice yang gagal diproses
  

Contoh Request

POST /rest/tagih/merchantpaymentnotif HTTP/1.1 Host: sandbox-api.espay.id Connection: keep-alive Content-Type: application/x-www-form-urlencoded Accept: */* rq_uuid=80784df2-accb-46fc-92f4-8d3103b38408 &rq_datetime=2021-10-23 22:51:45 &comm_code=SGWBUKUKUSC &member_code=2c4516b6 &signature=e7bb3339e618b6fb8ce3035edc83456813efb962e9f2c2b286e92387615b6f15 &tx_id=025e0ca44861a9076c8Z83f &tx_date=2018-02-27 09:57:45 &invoices=[{"IN-DGI773246": "90000"}] &bank=BCA &payment_type=VA
  

Contoh Response

{ "rq_uuid": "baefa025e0ca44861a9076c8Z83fccxx", "rs_datetime": "2018-02-27 11:57:45", "error_code": "0000", "error_message": "Success", "invoices": { "IN-DGI773246": "Success" }, "total_invoice": 1, "total_success": 1, "total_error": 0 }