Tagih.id

Payment Notification

Payment Notification merupakan layanan yang digunakan Espay untuk memberi tahu Anda bahwa pembayaran tagihan telah berhasil dilakukan. Anda harus menanggapi dalam format yang ditentukan dan mendaftarkan URL Pemberitahuan Pembayaran Anda di Portal Sandbox Espay.

Flow

Setiap kali pembayaran tagihan berhasil dikumpulkan, Tagih.id akan mengirimkan permintaan ke server Anda melalui URL Payment Notification yang terdaftar di Espay Sandbox Portal. Anda diminta untuk merespons dalam format JSON menggunakan format yang disediakan.

API URL

Method URL
HTTPS
https://yourwebsite.com/payment

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.

Format:
Rekomendasi UUID V.4
rq_datetime
String
Y
Tanggal dan waktu request transaksi.

Format:
Y-m-d H:i:s

Contoh:
2024-12-16 14:30:45
password
String (32)
Y
Kata sandi yang diberikan oleh tim Espay. Merchant menggunakan kata sandi untuk melakukan identifikasi dan validasi permintaan.
member_code
String (32)
Y
Kode member.
comm_code
String (32)
Y
Kode wilayah member.

Contoh:
SGWYESSISHOP
trx_id
String (16)
Y
ID transaksi dari Espay.
trx_date
String
Y
Tanggal dan waktu transaksi.

Format:
Y-m-d H:i:s

Contoh:
2024-12-16 14:30:45
total_amount
String (13.2)
Y
Total tagihan yang sudah terkumpul.

Format:
250000
outstanding_amount
String (13.2)
Y
Total tagihan yang belum dibayar.

Format:
150000
invoice
JSON
Y
Detail invoice.
collector
String (50)
Y
Identitas kolektor.
pay_type
String (10)
Y
Tipe pembayaran.
signature
String
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari Tagih.id | Hash-Based Signature
Y: Yes, O: Optional, C: Conditional

Parameter Respons

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

Format:
Y-m-d H:i:s

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

Format:
  • 0000: Berhasil
  • XXXX: Gagal
error_message
String
Y
Deskripsi respons.
trx_id
String (16)
Y
ID transaksi dari Espay.
reconcile_id
String (20)
Y
ID rekonsiliasi. Digunakan untuk konfirmasi bahwa mitra sudah berhasil menerima notifikasi.
reconcile_datetime
String
Y
Tanggal dan waktu rekonsiliasi.

Format:
Y-m-d H:i:s

Contoh:
2024-12-16 14:30:45
Y: Yes, O: Optional, C: Conditional

Pendaftaran URL

Pastikan format URL dan respons yang Anda buat sudah sesuai dengan panduan dokumentasi ini. Selanjutnya, segera daftarakan URL Payment Notification Anda melalui portal Sandbox Espay. Baca cara menambahkan URL disini.







































Contoh Permintaan

POST /payment HTTP/1.1
Host: mechant-domain.com
Content-Type: application/x-www-form-urlencoded
Accept: */*

rq_uuid=4445a53b-4bac-4159-ac69-f02149f53302&
rq_datetime=2021-06-23 13:29:49&
password=y1eh1rg&
comm_code=SGWMERCHANTTGR&
trx_id=ESP162442973 2I2O3&
trx_date=2021-06-23 13:29:49&
total_amount=4000&
outstanding_amount=4000&
invoice={
    "invoice number": "21190633",
    "0020510494": "442055",
    "0020510495": "5175625",
    "0020510496": "22982074",
    "0020510497": "11032255",
    "0020510498": "157317",
    "20210004046882": "-74171",
    "20210004046883": "-18052",
    "20210004046884": "-1272000",
    "20210004046885": "-4033000",
    "20210004046886": "-1250000",
    "20210004046887": "-2500000",
    "20210004046888": "-2250000",
    "20210004048138": "-600000",
    "20210004048139": "-2092934",
    "20210004048140": "-600000",
    "20210004048141": "-1597893",
    "20210004048168": "-550000"
}&
[email protected]&
pay_type=cash&
signature=437cd81ccdc09d0f































Contoh Respons

{
    "rq_uuid":"ebf8e9df-639e-424f-8148-94d2741edd03", 
    "rs_datetime":"2020-10-01T22:55:14+07:00", 
    "error_code":"0000",
    "error_message":"Success",
    "order_id":" ESP1624429732I2O3", 
    "reconcile_id":"2020100121183111", 
    "reconcile_datetime":"2020-10-01 22:56:13"
}




cURL

...





Scroll to Top