Faspay
Search
⌃K

Payment Notification

A process for sending notifications to the merchant's payment of Faspay. Payment notifications sent via URL merchant who previously had been prepared, which is the URL to receive notifications of transactions hit. Faspay will retry send a payment notification 3 times if the first try not get response ok.
Endpoint URL Payment Notification
Endpoint URL is used as a feedback URL that will process the data in the notification from Faspay to the merchant system. There are two URLs that needs to be used, namely Production and Development. For the implementation of the testing or UAT can use the URL development.
Request
Sample XML Request
Sample JSON Request
Parameter
Data Type
M/O/C
Description
request
Alfanumeric (50)
O
Request Description
trx_id
Numeric (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
Alfanumeric (32)
M
Merchant Name
bill_no
Alfanumeric (32)
M
Order Number
payment_reff
Alfanumeric (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
Alfanumeric (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
Alfanumeric (32)
M
Payment channel description
signature
Alfanumeric
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>Faspay Online</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 Sukses</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": "Panin Asset Management",
"bill_no": "220171004154635022158001",
"payment_reff": "null",
"payment_date": "2017-10-04 15:46:35",
"payment_status_code": "2",
"payment_status_desc": "Payment Sukses",
"bill_total": "5000000",
"payment_total": "5000000",
"payment_channel_uid": "402",
"payment_channel": "Permata Virtual Account",
"signature": "075c4983ba9883d41e1b3eab0de580dfc73d875b"
}
Response Parameter Payment Notification
Response parameter are parameter that merchant need to prepare after receive payment notification from Faspay
Response
Sample XML Response
Sample JSON Response
parameter
Data Type
M/O/C
Description
trx_id
Numeric (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
Alfanumeric (32)
M
Order Number
response_code
Alfanumeric (2)
M
Response code
response_desc
Alfanumeric (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": "Panin Asset Management",
"bill_no": "220171004154635022158001",
"response_code": "00",
"response_desc": "Success",
"response_date": "2017-10-05 16:53:10"
}