Send Invoice To Generate Virtual Account



Mitra akan mengirimkan invoice ke Espay kemudian Espay akan meresponse dengan JSON format berisi nomor va dan keterangan lain.


Alur Pesan

Merchant -> Espay

Metode

HTTP Post

API URL

Development : https://sandbox-api.espay.id/rest/merchantpg/sendinvoice
Production : https://api.espay.id/rest/merchantpg/sendinvoice



Parameter Request:
Nama Parameter Max Length Mandatory Keterangan
rq_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 saat pesan terkirim
order_id 32 Ya Transaction Number / Invoice Id / unique id yang dapat mengidentifikasi tagihan yang dimiliki pelanggan mitra
ccy 3 Ya Kode mata uang dari tagihan yang ingin yang dibayarkan contoh IDR
comm_code 32 Ya Kode merchant yang terdaftar pada aplikasi Espay
remark1 17 Tidak Deskripsi pertama. Mandatory bisa “Ya” mengkuti skema. Diisi dengan No Handphone
remark2 17 Ya Deskripsi kedua. Diisi dengan Nama
remark3 17 Tidak Deskripsi ketiga. Diisi dengan alamat email
remark4 32 Tidak Deskripsi keempat. Diisi dengan ID unik merchant yang akan digunakan Espay untuk validasi transaksi. Khusus VA Static.
update 1 Ya Di isi Y jika ingin mengupdate data terhadap order_id yang telah terdaftar
Di isi N jika ingin mendaftarkan order_id baru
bank_code 3 Ya Kode bank yang akan dijadikan pembayaran. Contoh: 008, 016 or show this Table of Bank Code
va_expired 20 Tidak Untuk setup waktu expired dari VA tersebut. (dalam satuan menit)
Contoh: 4000 (artinya akan expired dalam 4000 menit)
amount 17 Ya Jumlah total tagihan yang akan dibayarkan oleh pelanggan mitra dengan 2 digit terakhir adalah desimal dari pembayaran
signature 64 Ya Signature yang harus divalidasi oleh Espay, lihat halaman ini untuk detailnya


Parameter Response:
Nama Parameter Max Length Mandatory Keterangan
rq_uuid 4 Ya Request identifier. Id unik untuk mengidentifikasi pesan ini dengan pesan lainnya
rs_datetime 32 Ya Tanggal dan waktu di server aplikasi Espay saat pesan terkirim
error_code 4 Ya Kode error pada web service, 0000 artinya success
error_message 32 Ya Deskripsi error
va_number 16 Ya Virtual Account Number yang digunakan customer untuk membayar.
expired 19 Ya Tanggal dan waktu Virtual Account Number akan kadaluarsa.
description 32 Ya Deskripsi.
total_amount 17 Ya Total Harga dari Merchant + biaya administrasi.
amount 17 Ya Total Harga dari Merchant.
fee 17 Ya biaya administrasi.
  

Contoh Request

POST /rest/merchantpg/sendinvoice HTTP/1.1 Host: sandbox-api.espay.id Connection: keep-alive Content-Length: 250 Content-Type: application/x-www-form-urlencoded Accept: */* rq_uuid=fbd39734-ed32-490d-98c4-e91bcd91037a &rq_datetime=2021-10-25 09:01:16 &order_id=21102509019CO9R &amount=754000.00 &ccy=IDR &comm_code=SGWTRAVELAJAOTAWEB &remark1=53620211011190253332 &remark2=TravelAja OTA Web Tiara Iyay &remark3=likesupa@gmail.com &remark4=invoiceid0001 &bank_code=008 &signature=49652ef7ada6326460230b841a231e89b28fe838a55f23836fdfa2f7be008ee2 &va_expired=10
  

Contoh Response

{ { "rq_uuid": "baefa025e0ca44861a9076c8Z83fccxx", "rs_datetime": "2018-02-27 11:57:45", "error_code": "0000", "error_message": "", "va_number": "6280615238775939", "expired": "2018-05-17 14:00:00", "description": "Test Pembayaran VA", "total_amount": "10000.00", "amount": "10000", "fee": "0.00" }