espay logo

Merchant Check Point

Proses ini digunakan jika merchant ingin mengetahui apakah customer sudah membayar transaksi 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/merchantcheckinvoice

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


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
invoices JSON Ya Detail transaksi
Format: {invoice_no:amount}
Contoh: {INV001:
90000,INV002:50000}

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": "0000","IN-DGI773247": "0001"}
0000 = Success
0001 = Invoice Not Found
0002 = Invoice Is Already Paid
0003 = Invoice is rejected
0004 = Amount is not valid 
  

  
Contoh Request

    
POST /rest/tagih/merchantcheckinvoice 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
&invoices=[{"IN-DGI773246": "90000","IN-DGI773247":"50000"}]
    
  
  

  
Contoh Response

  
  {
      "rq_uuid": "baefa025e0ca44861a9076c8Z83fccxx",
      "rs_datetime": "2018-02-27 11:57:45",
      "error_code": "0000",
      "error_message": "Success",
      "invoices": {
          "IN-DGI773246": "0000",
          "IN-DGI773247": "0001"
      }
  }