Check Payment Status
Proses ini digunakan jika merchant ingin mengetahui apakah customer mereka sudah membayar transaksi mereka. Merchant akan mengirimkan request ke sistem Espay, lalu Espay akan memberikan response dengan format json seperti contoh dibawah ini
Alur Pesan
Merchant -> Espay
Metode
HTTP Post
API URL
Development : https://sandbox-api.espay.id/rest/merchant/status
Production : https://api.espay.id/rest/merchant/status
Parameter Request:
| Nama Parameter | Attribute | Mandatory | Keterangan |
| uuid | 64 | Ya | Request identifier. Id unik untuk mengidentifikasi pesan ini dengan pesan lainnya |
| rq_datetime | 19 | Ya | Tanggal dan waktu di server aplikasi Espay ketika pesan dikirim |
| comm_code | 32 | Ya | Kode merchant yang terdaftar pada aplikasi Espay |
| order_id | 20 | Ya | Nomor transaksi / Id invoice / id unik untuk mengidentifikasi order/ billing/ invoice. |
| is_paymentnotif | 1 | Tidak | Jika di Isi:
Y = akan paymentnotif ulang ke url paymentnotif mitra N = akan mengupdate trx_status menjadi S di portal Espay Tidak kirim param ini/diisi "" = akan melakukan check payment status saja |
| signature | 64 | Ya | Signature yang harus divalidasi oleh merchant. Lihat API Signature |
Parameter Response:
| Nama Parameter | Attribute | Mandatory | Keterangan |
| rq_uuid | 4 | Ya | Request identifier. Id unik untuk mengindentifikasi pesan ini dan pesan lainnya |
| rs_datetime | 32 | Ya | Tanggal dan waktu server Espay saat messages response |
| error_code | 4 | Ya | Kode error web service, 0000 berarti success |
| error_message | 32 | Ya | Deskripsi error |
| comm_code | 32 | Tidak | Kode komunitas merchant yang terdaftar di aplikasi Espay |
| tx_id | 20 | Tidak | ID transaksi yang dihasilkan oleh bank |
| order_id | 32 | Tidak | Nomor transaksi/ Id invoice? id unik untuk mengidentifikasi order/ billing/ invoice. |
| ccy_id | 3 | Tidak | Kode mata uang transaksi. Contoh : IDR / USD |
| amount | 13 | Tidak | Jumlah yang telah dibayar oleh pelanggan |
| tx_status | 2 | Ya | Payment status :
S = Success F = Failed SP = Suspect IP = In Process EX = Expired WC = Waiting Correction (Format Value payment notification tidak sesuai) |
| tx_reason | 50 | Tidak | Penjelasan Pembayaran |
| tx_date | 10 | Tidak | Tanggal Pembayaran |
| created | 20 | Tidak | Waktu Transaksi dibuat |
| expired | 20 | Tidak | Batas waktu transaksi |
| bank_name | 32 | Tidak | Nama Bank untuk pembayaran |
| product_name | 32 | Tidak | Nama Channel Bank |
| product_value | 32 | Tidak | Kode Channel Bank |
| payment_ref | 32 | Tidak | Referensi nomor transaksi (digunakan untuk identitas transaksi) yang tercatat di sistem Espay |
| merchant_code | 32 | Tidak | Kode merchant yang diberikan oleh Espay |