espay logo

Settlement Notification

Proses ini digunakan Tagih.id untuk menginformasikan tagihan yang telah dilunasi ke sistem Merchant, kemudian Merchant harus memberikan respon dengan format string dengan contoh di bawah ini:


Alur Pesan

Tagih.id -> Merchant

Metode

HTTP Post

API URL

http://www.yourwebsite.com/billingpaymentnotification.php or
https://www.yourwebsite.com/billingpaymentnotification.php



Parameter Request:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 64 Ya Minta pengenal. ID unik untuk mengidentifikasi pesan ini dengan pesan lain
rq_datetime 19 Ya Server tagih.id datetime lokal saat respons pesan
receiver_id 10 Ya Kode komunitas merchant tertera di aplikasi Tagih.id
password 20 Ya Kata sandi merchant diatur di aplikasi Tagih.id
data JSON Ya [{"tx_id":"ESP1588571015HGVU","payment_id":"INV2005012","settlement_amount":"410000.00","settlement_date":"2020-05-20","settlement_remark":"SGWBR04052004052068V"}]
comm_code 10 Ya Kode komunitas merchant tertera di aplikasi Tagih.id
settlement_fee 13.2 Ya Biaya Settlement
bank_ref 32 Ya Nomor Bank Referensi
amount 13.2 Ya Total Biaya Settlement
count_trx 13.2 Ya Jumlah total transaksi
signature 64 Ya Tanda tangan dibuat oleh merchant dan akan divalidasi oleh Tagih.id, lihat halaman di sini untuk lebih jelasnya


Parameter Response:
Nama Parameter Max Length Mandatory Keterangan
error_code 4 Ya Kode error web service, 0000 berarti sukses
error_message 32 Ya Deskripsi Error
settlement_remark 255 Tidak Keterangan dari settlement tersebut
date_settle Datetime Ya Tanggal settlement di server aplikasi
Format : YYYY-MM-DD HH:MM:SS Ex : 2014-12-17 12:30:45 
   
    

    
Contoh Request :

    
POST /api/espay/settlementnotification HTTP/1.1
Host: payment.daftarsekolah.com
Accept: */*
User-Agent: ESPay WebServices (Pembayaran Lintas Usaha Sukses, PT)
Content-Length: 541
Content-Type: application/x-www-form-urlencoded

rq_uuid=9f75543e-4684-4d06-a8a2-870b9d0f8830
&rq_datetime=2021-09-28 09:30:09
&sender_id=GOWORLDPG
&receiver_id=SGWBARKAHPANGHURIANSC
&password=FHNGNYDB
&data=[{"tx_id":"ESP1632751045TRBI","payment_id":"NNN0002021092700006","settlement_amount":"50000.00","settlement_date":"2021-09-28","settlement_remark":"SGWBA2709270921YNQ"}]
&comm_code=SGWBARKAHPANGHURIANSC
&settlement_fee=7000.00
&bank_ref=permata&amount=50000
&count_trx=1
&signature=4b31a51eca1sbdb9d86677da522d8d0f3d882d3c0

    

Contoh Response sukses :

  {
    {
      "error_code":"0000"
      "error_message":"Success"
      "settlement_remark":"notes here"
      "date_settle":"2021-10-17 12:30:45"
    }
    
  
Contoh Response sukses :

  {
      0, Success, 2014-12-17 12:30:45
    
  
Contoh Response error :

    {
      1, Internal Error,,