Send Invoice To Generate Virtual Account

Merchant will send invoice to Espay and Espay will respond with JSON format containing VA number and other descriptions.


Flow

Merchant -> Espay

Method

HTTP Post

API URL

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



Parameter Request:
Parameter Name Max Length Mandatory Description
rq_uuid 64 Yes Request identifier. Unique id to identify these messages with other messages
rq_datetime 19 Yes Date and time in Espay application server when messages sent
order_id 32 Yes Transaction Number / Invoice Id / unique id that identify the order / billing / invoice
amount 17 Yes Amount paid by the customer, with 2 decimal digits
ccy 3 Yes Transaction’s currency code. ex: IDR
comm_code 32 Yes Merchant code listed in the Espay application
remark1 17 No First description. Mandatory can be “Yes” follow the scheme. Filled with phone number
remark2 17 Yes Second description. Filled with name
remark3 17 No Third description. Filled with email address
update 1 Yes Enter Y if you want to update the data to the registered order_id
Enter N if you want to register a new order_id
bank_code 3 Yes The chosen Bank Code. Ex: 008, 016 or show this Table of Bank Code
va_expired 20 No How to set up the elapsed time of the VA (in minutes)
Example: 4000 (in explanation it will expire in 4000 minutes)
signature 64 Yes Signature required to validate by merchant, see page here for more detail


Parameter Response:
Parameter Name Max Length Mandatory Description
rq_uuid 4 Yes Request identifier. Unique id to identify these messages with other messages
rq_datetime 32 Yes Date and time in Espay application server when messages sent
error_code 4 Yes Error code of web service, 0000 means success
error_message 32 Yes Error description
va_number 16 Yes Virtual Account Number that customer used for payment.
expired 19 Yes Date and Time the Virtual Account Number will expired.
description 32 Yes Description.
total_amount 17 Yes Total Amount from Merchant + fee.
amount 17 Yes Total Amount from Merchant.
fee 17 Yes Administration Fee.



































































Sample 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 PembaYesran VA", "total_amount": "10000.00", "amount": "10000", "fee": "0.00" }