espay logo

Settlement Notification

This process use for Tagih.id inform the settled billing to Merchant system, then Merchant must give response with string format with below example:


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:
Parameter Name Max Length Mandatory Description
rq_uuid 64 Yes Request identifier. Unique id to identify these messages with other messages
rq_datetime 19 Yes Local datetime Tagih.id server when messages response
receiver_id 10 Yes Merchant community code listed in the Tagih.id application
password 20 Yes Merchant password set in the Tagih.id application
data JSON Yes [{"tx_id":"ESP1588571015HGVU","payment_id":"INV2005012","settlement_amount":"410000.00","settlement_date":"2020-05-20","settlement_remark":"SGWBR04052004052068V"}]
comm_code 10 Yes Merchant community code listed in the Tagih.id application
settlement_fee 13.2 Yes Settlement Fee
bank_ref 32 Yes Bank Reference Number
amount 13.2 Yes Total settlement amount
count_trx 13.2 Yes Total count of transaction
signature 64 Yes Signature generated by merchant and will validate by Tagih.id, see page here for more detail


Parameter Response:
Parameter Name Max Length Mandatory Description
error_code 4 Yes Error code of web service, 0000 means success
error_message 32 Yes Error Description
settlement_remark 255 No Description from the settlement
date_settle Datetime Yes Settlement date in application server
Format : YYYY-MM-DD HH:MM:SS Ex : 2014-12-17 12:30:45 
   
    

    
Sample 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

    

Sample Response Success :

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

  {
      0, Success, 2014-12-17 12:30:45
    
  
Sample Response Error :

    {
      1, Internal Error,,