Inquiry Transaction

Saat mengarahkan ke halaman pembayaran, ESPAY akan menanyakan detail transaksi ke pedagang sistem berdasarkan id pesanan yang diberikan oleh pedagang. Detail transaksi ini akan ditampilkan ke pelanggan ketika pelanggan berada di halaman pembayaran dan untuk memberi tahu sistem bank tentang jumlah yang akan 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

error_code;error_message;order_id;amount;ccy;description;trx_date

Credit card tokenization:

error_code;error_message;order_id;amount;ccy;description;trx_date;token;is_token

Contoh response sukses dari penjual:

0;Success;TX151028132832A001;50000.00;IDR;Payment For Me;28/10/2015 13:28:32

Contoh response gagal dari penjual:

1;Invalid Order Id;;;;;

Contoh response credit card tokenization:

0;Success;TX151028132832A001;50000.00;IDR;Payment For Me;28/10/2015 13:28:32;3123123123;Y

Alur Pesan

ESPAY -> Penjual

Metode

HTTP Post

API URL

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


Parameter Request:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 64 Ya ESPAY meminta pengenal. ID unik untuk setiap permintaan
rq_datetime 23 Ya Tanggal dan waktu dalam sistem ESPAY saat permintaan dikirim
password 32 Tidak Kata sandi yang digunakan untuk identifikasi dan validasi mekanisme oleh pedagang untuk memverifikasi bahwa ada permintaan sepenuhnya berasal dari sistem ESPAY
signature 64 Ya Meminta signature, 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 / Invoice Id / unique id itu mengidentifikasi pesanan / penagihan / faktur

Parameter Response:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 64 Ya ESPAY meminta pengenal. ID unik untuk setiap permintaan
rs_datetime 23 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
amount 13.2 Ya Jumlah yang dibayarkan oleh pelanggan.
Format : 100000.00
ccy 3 Ya Kode mata uang transaksi. Contoh : Rp
description 32 Ya Deskripsi transaksi
trx_date 19 Ya Tanggal transaksi di sistem Merchant
Format : YYYY-MM-DD hh:mm:ss
installment_period 3 Tidak Opsi saat ini:
30D = 30 Hari
3M = 3 Bulan
6M = 6 Bulan
12M = 12 Bulan
customer_details Tidak Lihat Customer Detail
shipping_address Tidak Lihat Shipping Address

Customer Details
Nama Parameter Max Length Mandatory Keterangan
firstname 32 Ya
lastname 32 Tidak
phone_number 16 Ya
email 32 Ya

Shipping Address
Nama Parameter Max Length Mandatory Keterangan
firstname 32 Ya
lastname 32 Tidak
address 64 Ya
city 32 Ya
postal_code 8 Ya
phone_number 16 Ya
country_code 3 Ya ISO 3166-1 alpha-3
  

Contoh Request:

POST /path/for/inquiry 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
  

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", "amount":"150000.00", "ccy":"IDR", "description":"Pembelian Barang", "trx_date":"2020-10-01 22:55:06", "installment_period":"6M", "signature": "", "token":"", "customer_details": { "firstname":"Paul", "lastname":"Weller", "phone_number":"081234567878", "email":"paul.weller@mod.co.uk", }, "shipping_address":{ "firstname":"Oemang", "lastname":"Tandra", "address":"Jalan Teknologi Indonesia No. 25", "city":"Jakarta", "postal_code":"12960", "phone":"081234567878", "country_code":"IDN" } }

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" }