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"
}
Last modified 11mo ago