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