Create Virtual Account



Virtual Account merupakan rekening buatan yang tidak benar-benar nyata atau virtual. Biasanya dalam akun ini terdapat nomor ID pelanggan yang dibuat oleh Bank. Pembuatan akun dapat dilakukan sesuai permintaan perusahaan dengan tujuan untuk melakukan transaksi. Pada setiap transaksi, pelanggan akan mendapatkan satu ID akun atau biasa dikenal dengan VA number. Selanjutnya, masing-masing pelanggan diberikan virtual account yang unik dan berbeda, serta bisa diatur sesuai kebutuhan

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

Format message yang dikirimkan harus dalam bentuk URL encoded. Keterangan untuk setiap field dalam HTTP POST message tersebut:

Parameter Request

Nama Field Attribute 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
amount 17 Ya Jumlah total tagihan yang akan dibayarkan oleh pelanggan mitra dengan 2 digit terakhir adalah desimal dari pembayaran
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 32 No Deskripsi pertama. Mandatory bisa “Ya” mengkuti skema. Diisi dengan No Handphone
remark2 32 Yes Deskripsi kedua. Diisi dengan Nama
remark3 32 No Deskripsi ketiga. Diisi dengan alamat email
update 1 Yes 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 atau dll.
va_expired 20 No Untuk setup waktu expired dari VA tersebut. (dalam satuan menit)
Contoh: 4000 (artinya akan expired dalam 4000 menit)
signature 64 Ya Signature yang harus divalidasi oleh Espay, lihat halaman ini untuk detailnya

Lalu ESPAY melakukan inquiry terhadap Merchant

Inquiry Request Data

Nama Field Attribute Mandatory Keterangan
rq_uuid 64 Ya Pengidentifikasi request. ID unik untuk mengidentifikasi pesan-pesan tersebut dengan pesan yang lain
rq_datetime 19 Ya Tanggal dan waktu di server aplikasi Espay ketika pesan dikirim
member_id 20 Tidak Kode pelanggan jika terdaftar di aplikasi Espay
comm_code 10 Ya Kode penjual yang terdaftar di aplikasi Espay
order_id 20 Ya Nomor transaksi / ID faktur / ID unik yang mengidentifikasi pesanan / tagihan / faktur
password 32 Tidak Password digunakan untuk mengidentifikasi dan mekanisme validasi oleh penjual untuk mengidentifikasi request secara menyeluruh dari aplikasi Espay
signature 64 Ya Signature diperlukan untuk validasi oleh penjual

Setelah itu, Merchant akan meresponse request

Inquiry Response Data

Nama Field Attribute Mandatory Keterangan
error_code 4 Ya Penjual akan memberikan informasi tentang request berdasarkan bidang ini.
0 = Sukses, proses di penjual telah sukses
lainnya = failed, proses di penjual telah gagal (validasi bermasalah, proses bisnis tidak sesuai, atau masalah lainnya)
error_message 32 Ya Jika error_code sama dengan 0 = Sukses
Jika error_code tidak sama dengan 0, silahkan sisipkan pesan atau keterangan masalah pada bidang ini
order_id 20 Tidak Nomor transaksi / ID faktur / ID unik yang mengidentifikasikan pesanan / tagihan / faktur
amount 13.2 Tidak Jumlah yang harus dibayar oleh pelanggan
Format : 100000.00
ccy 3 Tidak Kode mata uang transaksi. contoh: IDR / USD
description 32 Tidak Deskripsi transaksi
trx_date 19 Tidak Tanggal transaksi di server penjual
Format : DD/MM/YYYYhh:mm:ss

Setelah melakukan request dengan contoh diatas, Merchant akan mendapatkan response. Dengan contoh sebagai berikut :

Parameter Response

Nama Field Attribute 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.
POST /rest/biller/inquirytransaction HTTP/1.0
Host: sandbox.api.espay.id
Content-Length: 108
Authorization: Basic QWxhZGRpbjpTbWVsYW5h
Content-type: application/x-www-form-urlencoded

rq_uuid=5441217&rq_datetime=2014-12-09 17:53:20&sender_id=SENDERID&order_id=9900990099&product_code=STCKAI
    
{
    "rq_uuid"    : "MERCHANT1568345855CTAFI5WIOT",
    "rs_datetime": "2019-09-13 10:37:36",
    "error_code" : "0000",
    "error_desc" : "Success",
    "order_id"   : "520520795556",
    "amount"     : "2250000",
    "bill_amount": "2000000",
    "admin_fee"  : "250000",
    "data"       : [data dapat berbeda sesuai produk Biller]
}