Tagih.id

Reject Billing Multiple

Reject Billing Multiple adalah layanan dari Tagih.id yang memudahkan proses penolakan tagihan dalam jumlah besar. Dalam satu kali permintaan, layanan ini dapat digunakan untuk menolak hingga maksimal 500 tagihan sekaligus.

Sebelum Integrasi

Pastikan Anda sudah menerima kredensial dari tim Espay.

Langkah Integrasi

Berikut ini merupakan langkah-langkah yang dapat Anda gunakan untuk integrasi dengan Reject Billing Multiple.

1. Generate Signature
Setiap permintaan yang Anda kirim, akan divalidasi oleh Tagih.id menggunakan parameter signature yang telah Anda buat. Pelajari pembuatan Tagih.id | Hash-Based Signature.
2. Enkripsi Data
Enkripsi data merupakan proses mengubah informasi data kedalam bentuk yang tidak dapat dibaca agar informasi data lebih aman. Setiap kali melakukan transaksi, Anda wajib mengenkripsi value dari parameter yang dikirim. Daftar parameter yang harus dienkripsi dapat dilihat pada bagian Parameter Permintaan dan Parameter Respons. Pelajari cara enkripsi data Tagih.id | AES-256-CBC Encryption.
3. Membuat Reject Billing

Flow

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

API URL

Environment URL
Sandbox
https://sandbox-api.espay.id/rest/tagihid/rejectbilling
Production
https://api.espay.id/rest/tagihid/rejectbilling

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 Enkripsi Keterangan
rq_uuid
String (255)
Y
N
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.

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

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

Contoh:
2024-12-16 14:30:45
signature
String (64)
Y
N
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Tagih.id | Hash-Based Signature
sender_id
String (32)
Y
N
Id merchant yang diberikan oleh tim Espay.
comm_code
String (32)
Y
Y
Merchant code yang diberikan oleh tim Espay.
invoices
JSON
Y
Y
Detail invoice, maksimum 500 baris.

Format:
{"doc_no":{"member_code":"01S000118545"}}

Contoh:
{ "MT18200000361": { "member_code": "01S000118545" } }
   doc_no
Nomor invoice.

Contoh:
MT18200000361
  member_code
Kode member.

Contoh:
01S000118545
total_invoices
String (3)
Y
Y
Jumlah total invoice yang dikirim. Maksimal pengiriman 500 invoice dalam bentuk JSON.

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

Parameter Respons

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

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

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

Format:
  • Berhasil: 0000
  • Gagal: XXXX
error_message
String
C
Y
Deskripsi respons.
invoices_success
JSON
Y
Y
Invoice berhasil.

Format:
  • Sukses:0000
  • Gagal: Lainnya

Contoh:
{"MT18200000360":"MT18200000360"}
invoices_failed
JSON
Y
Y
Invoice gagal.

Format:
  • Sukses: 0000
  • Gagal: Lainnya

Contoh:
{"MT18200000360":"MT18200000360"}
total_success
String
Y
Y
Total invoice berhasil.

Contoh:
15
total_failed
String
Y
Y
Total invoice gagal.

Contoh:
20
total_row_execute
String
Y
Y
Total invoice yang telah diproses.

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














































































































































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