Tagih.id

Merchant Check Invoice

Merchant Check Invoice adalah layanan dari Tagih.id yang digunakan untuk mengecek status pembayaran dari customer Anda.

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Tagih.id akan memberikan respons dalam bentuk JSON.

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>

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.

Contoh:
123ABC-DEF456
rq_datetime
String (19)
Y
Tanggal dan waktu request transaksi.

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

Contoh:
2024-12-16 14:30:45
comm_code
String (10)
Y
Merchant code yang diberikan oleh tim Espay.
member_code
String (20)
Y
Kode member yang diberikan oleh Tim Espay.
signature
String (64)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Tagih.id | Hash-Based Signature
invoices
JSON
Y
Detail invoice.

Format:
{invoice_no:amount}

Contoh:
{INV001: 90000,INV002:50000}
  invoice_no
Nomor invoice.

Contoh:
INV001
  amount
Jumlah tagihan.

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

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (4)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.
rs_datetime
String (32)
Y
Tanggal dan waktu respons transaksi.

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

Contoh:
2024-12-16 14:30:45
error_code
String (4)
Y
Kode respons.

Format:
  • Berhasil: 0000
  • Gagal: XXXX
error_message
String
Y
Deskripsi respons.
invoices
JSON
C
Detail invoice.

Format:
  • Berhasil:0000
  • Invoice tidak ditemukan: 0001
  • Invoice sudah dibayar: 0002
  • Invoice ditolak: 0003
  • Jumlah tidak valid: 0004

Contoh:
{"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