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,,