Tagih.id

Merchant Check Invoice

Merchant Check Invoice is a service from Tagih.id used to check the payment status of your customer.

Flow

You send the required parameters to make a request, and Tagih.id will respond in JSON format.

API URL

Environment URL
Sandbox
Port of HTTPS (443)
https://sandbox-api.espay.id/rest/tagih/merchantcheckinvoice
Production
Port of HTTPS (443)
https://api.espay.id/rest/tagih/merchantcheckinvoice

HTTP Header

Key Value
Method
POST
HTTP Version
HTTP/1.1
Accept
*/*
Content-Type
application/x-www-form-urlencoded
Content-Length
<dynamic>

Request Parameter

Parameter Type Mandatory Description
rq_uuid
String (64)
Y
Request identifier. A unique ID used to identify messages.

Example:
123ABC-DEF456
rq_datetime
String (19)
Y
Date and time of the transaction request from the merchant's server.

Format:
YYYY-MM-DD HH:MM:SS

Example:
2024-03-14 07:49:28
comm_code
String (10)
Y
Merchant code from Espay team.
member_code
String (20)
Y
Member code form espay team.
signature
String (64)
Y
Code used to validate transactions. Learn how to make a Tagih.id | Hash-Based Signature
invoices
JSON
Y
Invoice details.

Format:
{invoice_no:amount}

Example:
{INV001: 90000,INV002:50000}
  invoice_no
Invoice number.

Example:
INV001
  amount
Total invoice amount.

Example:
90000
Y: Yes, O: Optional, C: Conditional, N: No

Response Parameters

Parameter Type Mandatory Description
rq_uuid
String (4)
Y
Request identifier. A unique ID used to identify messages.

Example:
123ABC-DEF456
rs_datetime
String (32)
Y
Date and time of the transaction request from the merchant's server.

Format:
YYYY-MM-DD HH:MM:SS

Example:
2024-03-14 07:49:28
error_code
String (4)
Y
Response code.

Format:
  • Success: 0000
  • Failure: XXXX
error_message
String
Y
Response description.
invoices
JSON
C
Invoice details.

Format:
  • Success:0000
  • Invoice Not Found: 0001
  • Invoice Is Already Paid: 0002
  • Invoice is Rejected: 0003
  • Amount is not valid: 0004

Example:
{"IN-DGI773246": "0000","IN-DGI773247": "0001"}
Y: Yes, O: Optional, C: Conditional, N: No
















































































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




HTTP

POST /rest/tagihid/sendbillingdigital HTTP/1.1
Host: sandbox-api.espay.id
Connection:  keep-alive
Content-Type: application/x-www-form-urlencoded
Accept:  */*
Content-Length: 972

rq_uuid=SGWYESSISHOP973962&rq_datetime=2025-06-30%2008%3A31%3A06&signature=a50e23f466757dbe328e7057a39ce41679135b64d7a40a5b6348b09b2add3d98&sender_id=SGWYESSISHOP&comm_code=7ehJDLKEnDvhoTaI0Ao3Fg%3D%3D&ccy=XAgDOyFSyCxclKSInvWVcw%3D%3D&invoices=AKxBlnttnPYeN7Sgxyx4nnKX8TdReEucJox4i7poIizxAvfqodP5raJ4aplvOdFM4W2cVtUrmXaxYYUXEvHOoYRjTME0IChs1Ihm3FdB148Ef8Z%2BJMR2XZqbw338vpNtlR6tShTs1bFfERYvDyo1Epf9WRlTanU79K4Ri%2BOALy73QpPxZmfc1e%2Bvmq0JbHt10K63x4qbcWuQDPAxwN6klbmAzByCg8tRU3hDPtLOUrhUrvrFmDBvPGbotHQkaOPXqSyqTlvMOxOgA0i4T0aGcdWp0pjv1wSNI0m4IUTJmCT15Vhy88vyX5Wy8BtctN6LnbFRd4eD3rsCHwxUkldXDPWIfu1bbt70kDGT9Ij5gZhIyoaeaVkDnKznEPFjGwhe%2Fwfg24g9Rjkv21FQJiI6VvNV1pxTmvLOn63t9KGfQgGu%2FWJSrTe6AyqjsZiYdMqA%2F5pLR0dsG5RSC23NhLMFmVzuYujxAgmlRL5k5260oaCZ1Ps0RbD05VMXXDePMA8ZAIGVEiiMLbek3IN9hGlig26xJM2At1m6fesQlhhnOqtlXCDRSEsLkYqsIkA6sOr9DGLJcRE6mjK12GB6RUkfRZg73%2FlMvQ7WjjqQBtukk04sOWPUvxiCbMA75c7FbWDrgWF1yoYFuX6DZHrWzZgDmA%3D%3D&total_invoices=I3QGPJlhxrj9P2wjsQw%2FBw%3D%3D


CURL

curl --location 'https://sandbox-api.espay.id/rest/tagihid/sendbillingdigital' \
--header 'Connection:  keep-alive' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept:  */*' \
--data-urlencode 'rq_uuid=SGWYESSISHOP973962' \
--data-urlencode 'rq_datetime=2025-06-30 08:31:06' \
--data-urlencode 'signature=a50e23f466757dbe328e7057a39ce41679135b64d7a40a5b6348b09b2add3d98' \
--data-urlencode 'sender_id=SGWYESSISHOP' \
--data-urlencode 'comm_code=7ehJDLKEnDvhoTaI0Ao3Fg==' \
--data-urlencode 'ccy=XAgDOyFSyCxclKSInvWVcw==' \
--data-urlencode 'invoices=AKxBlnttnPYeN7Sgxyx4nnKX8TdReEucJox4i7poIizxAvfqodP5raJ4aplvOdFM4W2cVtUrmXaxYYUXEvHOoYRjTME0IChs1Ihm3FdB148Ef8Z+JMR2XZqbw338vpNtlR6tShTs1bFfERYvDyo1Epf9WRlTanU79K4Ri+OALy73QpPxZmfc1e+vmq0JbHt10K63x4qbcWuQDPAxwN6klbmAzByCg8tRU3hDPtLOUrhUrvrFmDBvPGbotHQkaOPXqSyqTlvMOxOgA0i4T0aGcdWp0pjv1wSNI0m4IUTJmCT15Vhy88vyX5Wy8BtctN6LnbFRd4eD3rsCHwxUkldXDPWIfu1bbt70kDGT9Ij5gZhIyoaeaVkDnKznEPFjGwhe/wfg24g9Rjkv21FQJiI6VvNV1pxTmvLOn63t9KGfQgGu/WJSrTe6AyqjsZiYdMqA/5pLR0dsG5RSC23NhLMFmVzuYujxAgmlRL5k5260oaCZ1Ps0RbD05VMXXDePMA8ZAIGVEiiMLbek3IN9hGlig26xJM2At1m6fesQlhhnOqtlXCDRSEsLkYqsIkA6sOr9DGLJcRE6mjK12GB6RUkfRZg73/lMvQ7WjjqQBtukk04sOWPUvxiCbMA75c7FbWDrgWF1yoYFuX6DZHrWzZgDmA==' \
--data-urlencode 'total_invoices=I3QGPJlhxrj9P2wjsQw/Bw=='
Scroll to Top