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 an 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. For the implementation of the testing, UAT can use URL development.

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))

Sample XML Request

<?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>

Sample JSON Request

{
  "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 notifications from Faspay.

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

Sample XML Response

<?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>

Sample JSON Response

{
    "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"
}