espay logo

Merchant Payment Notification

This process is used by merchants to send transaction payment notifications that are recorded on Tagih.id system but were not paid through Tagih.id. Merchants will send requests to Tagih.id system, and Tagih.id will respond in JSON format as shown below:

Flow

Merchant -> Tagih.id

Method

HTTP Post

API URL

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

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


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 date time Tagih.id server when messages are replied
comm_code 32 Yes Merchant community code listed in the Tagih.id application
member_code 20 Yes Merchant member code listed in the Tagih.id application
signature 64 Yes Signature generated by merchant to be validated by Tagih.id, see page here for more detail
tx_id 32 Yes Transaction Number / unique id that identifies the order / billing / invoice.
tx_date 19 Yes Date of the payment that will be executed
Format: yyyy-MM- dd hh:mm:ss
invoices JSON Yes Transaction's Detail
Format: {invoice_no:amount}
Example: {INV001: 90000,INV002:50000}
bank 25 No Destination bank name
payment_type 25 No Customer’s selected payment method
Example: cash, VA, CC, etc

Parameter Response:
Parameter Name/td> Max Length Mandatory Description
rq_uuid 4 Yes Request identifier. Unique id to identify these messages with other messages
rs_datetime 32 Yes Local date/time Tagih.id server when messages are replied
error_code 4 Yes Error code of web service, 0000 means success
error_message 32 Yes Error description
invoices JSON No Transaction's Detail
Example: {"IN-DGI773246": "Success"}
total_invoice 5 No Total invoices to be sent
total_success 5 No Total Invoices successfully processed
total_error 5 No Total Invoices that failed to be processed 
  

  
Sample 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
    
  
  

  
Sample 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
  }