espay logo

Merchant Check Point

This process is used for merchants to check if they customers have paid their transactions. Merchants will send request 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/merchantcheckinvoice

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


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 and will be validated by Tagih.id, see page here for more detail
invoices JSON Yes Transaction’s Detail
Format: {invoice_no:amount}
Example: {INV001: 90000,INV002:50000}

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

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

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