Faspay
Search
K

Payment Notification

A process for sending notifications to the merchant's payment of Faspay. Payment notifications are sent via URL merchant who previously had been prepared, which is the URL to receive notifications of transactions hit. Faspay will send a payment notification 3 times if the first try does not get a response ok.
Endpoint URL Payment Notification
The endpoint URL is a feedback URL that will process the data in the notification from Faspay to the merchant system. Two URLs need to be used, namely Production and Development. For the implementation of the testing or UAT can use URL development.
Request
Sample XML Request
Sample JSON Request
Parameter
Data Type
M/O/C
Description
request
Alphanumeric (50)
O
Request Description
trx_id
Alphanumeric (16)
M
Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired
merchant_id
Numeric (5)
M
Merchant Code
merchant
Alphanumeric (32)
M
Merchant Name
bill_no
Alphanumeric (32)
M
Order Number
payment_reff
Alphanumeric (32)
O
would be fill if the payment has been made
payment_date
Datetime YYYY-MM-DD HH:MM:SS
M
customer payment date would be fill if the payment has been made
payment_status_code
Char (1)
M
Payment Status
0 Unprocessed
1 In Process
2 Payment Success
3 Payment Failed
4 Payment Reversal
5 No bills found
7 Payment Expired
8 Payment Cancelled
9 Unknown
payment_status_desc
Alphanumeric (32)
M
Payment description
bill_total
Numeric
M
Billing total of transaction
payment_total
Numeric
M
Payment total of transaction
payment_channel_uid
Numeric
M
Payment channel code
payment_channel
Alphanumeric (32)
M
Payment channel description
signature
Alphanumeric
M
Sha1(md5(user_id+password + bill_no + payment_status_code))
<?xml version="1.0" encoding="UTF-8"?>
<faspay>
<request>Payment Notification</request>
<trx_id>8985310250011254</trx_id>
<merchant_id>31025</merchant_id>
<merchant>Sophia Store</merchant>
<bill_no>300134486</bill_no>
<payment_reff>null</payment_reff>
<payment_date>2017-08-10 11:43:18</payment_date>
<payment_status_code>2</payment_status_code>
<payment_status_desc>Payment Success</payment_status_desc>
<bill_total>5000000</bill_total>
<payment_total>5000000</payment_total>
<payment_channel_uid>402</payment_channel_uid>
<payment_channel>Permata Virtual Account</payment_channel>
<signature>9ed18926fa88f83b469f3ae73ef71ef2a4835c03</signature>
</faspay>
{
"request": "Payment Notification",
"trx_id": "3183540500001172",
"merchant_id": "31835",
"merchant": "Sophia Store",
"bill_no": "220171004154635022158001",
"payment_reff": "null",
"payment_date": "2017-10-04 15:46:35",
"payment_status_code": "2",
"payment_status_desc": "Payment Success",
"bill_total": "5000000",
"payment_total": "5000000",
"payment_channel_uid": "402",
"payment_channel": "Permata Virtual Account",
"signature": "075c4983ba9883d41e1b3eab0de580dfc73d875b"
}
Response Parameter Payment Notification
Response parameters are parameters that merchants need to prepare after receiving payment notification from Faspay.
Response
Sample XML Response
Sample JSON Response
Parameter
Data Type
M/O/C
Description
trx_id
Alphanumeric (16)
M
Transaction ID (Issued/generated by Faspay (Media Indonusa)) Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired
merchant_id
Numeric (15)
M
Channel Code From Faspay
bill_no
Alphanumeric (32)
M
Order Number
response_code
Alphanumeric (2)
M
Response code
response_desc
Alphanumeric (50)
M
Response Description
response_date
Datetime
M
Response date
<?xml version="1.0" encoding="utf-8"?>
<faspay>
<response>Payment Notification</response>
<trx_id>8985310250011254</trx_id>
<merchant_id>31025</merchant_id>
<bill_no>300134486</bill_no>
<response_code>00</response_code>
<response_desc>Success</response_desc>
<response_date>2017-08-10 04:43:45</response_date>
</faspay>
{
"response": "Payment Notification",
"trx_id": "3183540500001172",
"merchant_id": "31835",
"merchant": "Sophia Store",
"bill_no": "220171004154635022158001",
"response_code": "00",
"response_desc": "Success",
"response_date": "2017-10-05 16:53:10"
}