Payment Notification

Saat pelanggan telah menyelesaikan pembayaran, ESPAY langsung memberi tahu sistem pedagang tentang status pembayaran transaksi diproses.

ESPAY akan mengirimkan permintaan dan setelah pedagang menerima permintaan, pedagang diharapkan untuk melakukannya, tanggapi dengan JSON yang diformat seperti yang ditunjukkan pada template ini.


success_flag,error message,reconcile_id , order_id,reconcile_datetime

Contoh response sukses dari penjual :

0, Success, 0123162509216347301, TOP130123EBS58, 2013-01-23 16:26:00

Contoh response gagal dari penjual :

1, Invalid Order Id,,,

Alur Pesan

ESPAY -> Penjual

Metode

HTTP Post

API URL

http://www.yourwebsite.com/payment.php or
https://www.yourwebsite.com/payment.php



Parameter Request:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 64 Ya ESPAY meminta pengenal. ID unik untuk setiap permintaan
rq_datetime 19 Ya Tanggal dan waktu dalam sistem ESPAY saat permintaan terkirim
password 32 Tidak Kata sandi yang digunakan untuk identifikasi dan validasi mekanisme oleh pedagang untuk memverifikasi bahwa permintaan tersebut sepenuhnya berasal dari ESPAY sistem
signature 64 Ya Meminta pengenal. Lihat API Signature
member_id 20 Tidak Kode pelanggan jika terdaftar di sistem ESPAY
comm_code 32 Ya Kode pedagang terdaftar di sistem ESPAY
order_id 20 Ya Nomor Transaksi / Id Faktur / id unik yang mengidentifikasi pesanan / penagihan / faktur
ccy 3 Ya Kode mata uang transaksi. Contoh : Rp
amount 13.2 Ya Jumlah yang dibayarkan oleh pelanggan.
Format : 100000.00
debit_from_bank 20 Ya Kode bank dari akun sumber. Contoh :
008/016/002/dll
debit_from 19 Tidak Akun sumber (akun yang didebit)
debit_from_name 64 Tidak Nama akun sumber
credit_to_bank 20 Ya Kode bank dari akun sumber. Contoh :
008/016/002/dll
credit_to 19 Tidak Akun tujuan (akun yang dikreditkan)
credit_to_name 64 Tidak Nama akun tujuan
product_code 32 Ya Kode pembayaran produk
product_value 64 Tidak Isi nomor produk
Contoh:
Visa MANDIRI ID;002;411111xxxxxx1111
Tipe kartu Bin kartu Negara kartu;Bank acquirer;Masking kartu
card_expiry 6 Tidak Masa kadaluwarsa kartu kredit. Format (YYYYMM)
Contoh: 202512
message 32 Tidak Informasi tambahan tentang pembayaran
payment_datetime 19 Ya Tanggal dan waktu pembayaran tercantum di ESPAY
Format aplikasi : YYYY-MM-DD hh:mm:ss
payment_ref 20 Ya Nomor referensi transaksi (digunakan sebagai identitas transaksi) yang tercatat di Espay sistem
approval_code_full_bca 4 Tidak Kode persetujuan dari BCA jika menggunakan kartu transaksi debit BCA
approval_code_installment_bca 4 Tidak Kode persetujuan dari BCA jika menggunakan kartu transaksi kredit BCA


Parameter Response:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 64 Ya ESPAY meminta pengenal. ID unik untuk setiap permintaan
rs_datetime 19 Ya Respon DateTime pada sistem Merchant ketika permintaan terkirim
error_code 4 Ya Merchant akan memberikan informasi tentang permintaan berdasarkan bidang ini.
0 atau 0000 = Sukses, proses di sisi pedagang adalah berhasil
Lainnya = Gagal, proses di sisi pedagang gagal (kesalahan validasi, proses bisnis tidak cocok, atau masalah lain)
error_message 32 Ya Jika error_code tidak Berhasil, harap tulis pesannya atau deskripsi kesalahan di bidang ini
signature 64 Ya Respon signature. ESPAY akan memvalidasi signature tersebut. Lihat API Signature
order_id 20 Ya Nomor Transaksi / Invoice Id / unique id itu mengidentifikasi pesanan / penagihan / faktur
reconcile_id 20 Ya String / angka unik sebagai bukti pengakuan / konfirmasi bahwa mitra telah berhasil menerima notifikasi.
reconcile_datetime 19 Ya Tanggal transaksi dalam Format server pedagang :
YYYY-MM-DD hh:ii:ss
  

Contoh Request:

POST /path/for/notification HTTP/1.1 Host: merchant.domain Connection: keep-alive Content-Length: 250 Content-Type: application/x-www-form-urlencoded Accept: */* rq_uuid=ebf8e9df-639e-424f-8148-94d2741edd03 &rq_datetime=2020-10-01T22:55:14+07:00 &password=ServicePassword &signature=1e6be48271e94f8f08ca0ad52d4ee4c8b1d2155b471a7d34720bcca09d80e220 &member_id=SGWMERCHANT&comm_code=SGWMERCHANT &order_id=ESPTRX21183111 &ccy=IDR &amount=150000.00 &debit_from_bank=014 &debit_from=2731726215 &debit_from_name=PaulWeller &credit_to_bank=014 &credit_to=5250287544 &credit_to_name=SteveMarriott &product_code=KLIKPAY &message= &payment_datetime=2020-10-0124:55:14 &payment_ref=338746162U313G &approval_code_full_bca= &approval_code_installment_bca=
  

Contoh Response - Positif Response:

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

Contoh Response - Negatif Response:

{ Content-Type: application/json { "rq_uuid":"ebf8e9df-639e-424f-8148-94d2741edd03", "rs_datetime":"2020-10-01T22:55:14+07:00", "error_code":"0014", "error_message":"invalid order id" }