Payment Notification

When customers have completed the payment, Espay system directly notifies merchant’s system about the payment status of the transaction being processed.


Espay system will send the the request and once the merchant receives the request, merchant is expected to respond with comma (,) separator as shown in this template

success_flag,error message,reconcile_id , order_id,reconcile_datetime

Example of success response from merchant side :

0, Success, 0123162509216347301, TOP130123EBS58, 2013-01-23 16:26:00

Example of error response from merchant side :

1, Invalid Order Id,,,

Flow

ESPAY -> Merchant

Method

HTTP Post

API URL

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



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 are sent
member_id 20 No Customer code if listed in the Espay application
comm_code 32 Yes Merchant code listed in the Espay application
order_id 20 Yes Transaction Number / Invoice Id / unique id that identifies the order / billing / invoice.
Password 32 No Password used for identification and validation mechanisms by merchant to verify if a request is completely derived from the Espay application
ccy 3 Yes Transaction’s currency code. ex: IDR / USD
amount 13.2 Yes Amount paid by the customer.
Format : 100000.00
debit_from 19 No Source accounts (debited accounts)
debit_from_name 64 No Source account name
credit_to 19 No Destination account (credited account)
credit_to_name 64 No Destination account name
product_code 32 Yes Product code payment
message 32 No Additional information of payment
payment_datetime 19 Yes Date and time of payment listed on the Espay application
Format : YYYY-MM-DD hh:mm:ss
payment_ref 20 Yes Transaction reference number (used as transaction identity) recorded on the Espay system
debit_from_bank 20 Yes Bank code of source account. example :008, 016, etc
credit_to_bank 20 Yes Bank code of destination account. example :008,016, etc
approval_code_full_bca 4 No Approval code from BCA if using bca’s debit card transaction
approval_code_installment_bca 4 No Approval code from BCA if using bca’s credit card transaction
Signature 64 Yes Signature required to validate by merchant, see page here for more detail


Parameter Response:
Parameter Name Max Length Mandatory Description
error_code 4 Yes Merchant will give the information about the request based on this field.
0 = Success, process in merchant side is success
other = failed, process in merchant side is unsuccessful (validation error, business process does not match, or other causes)
error_message 32 Yes If error_code equal to 0 = Success
If error_code is not equal to 0, please put the message or description of the error on this field
reconcile_id 20 Yes Random unique string / number as proof of acknowledgment / confirmation that partner has successfully received the notification.
order_id 20 Yes Transaction Number / Invoice Id / unique id that identifies the order / billing / invoice
reconcile_datetime 20 Yes Transaction date in merchant’s server Format : 2020-07-09 16:57:12