# 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.

{% tabs %}
{% tab title="Request" %}

<table><thead><tr><th width="215">Parameter</th><th width="144">Data Type</th><th width="78">M/O/C</th><th width="296">Description</th></tr></thead><tbody><tr><td>request</td><td>Alphanumeric (50)</td><td>O</td><td>Request Description</td></tr><tr><td>trx_id</td><td>Alphanumeric (16)</td><td>M</td><td>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</td></tr><tr><td>merchant_id</td><td>Numeric (5)</td><td>M</td><td>Merchant Code</td></tr><tr><td>merchant</td><td>Alphanumeric (32)</td><td>M</td><td>Merchant Name</td></tr><tr><td>bill_no</td><td>Alphanumeric (32)</td><td>M</td><td>Order Number</td></tr><tr><td>payment_reff</td><td>Alphanumeric (32)</td><td>O</td><td>would be fill if the payment has been made</td></tr><tr><td>payment_date</td><td>Datetime YYYY-MM-DD HH:MM:SS</td><td>M</td><td>customer payment date would be fill if the payment has been made</td></tr><tr><td>payment_status_code</td><td>Char (1)</td><td>M</td><td><p>Payment Status </p><p>0 Unprocessed </p><p>1 In Process </p><p>2 Payment Success </p><p>3 Payment Failed </p><p>4 Payment Reversal </p><p>5 No bills found </p><p>7 Payment Expired </p><p>8 Payment Cancelled </p><p>9 Unknown</p></td></tr><tr><td>payment_status_desc</td><td>Alphanumeric (32)</td><td>M</td><td>Payment description</td></tr><tr><td>bill_total</td><td>Numeric</td><td>M</td><td>Billing total of transaction</td></tr><tr><td>payment_total</td><td>Numeric</td><td>M</td><td>Payment total of transaction</td></tr><tr><td>payment_channel_uid</td><td>Numeric</td><td>M</td><td>Payment channel code</td></tr><tr><td>payment_channel</td><td>Alphanumeric (32)</td><td>M</td><td>Payment channel description</td></tr><tr><td>signature</td><td>Alphanumeric</td><td>M</td><td>Sha1(md5(user_id+password + bill_no + payment_status_code))</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample XML Request" %}

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

{% endtab %}

{% tab title="Sample JSON Request" %}

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

{% endtab %}
{% endtabs %}

**Response Parameter Payment Notification**

Response parameters are parameters that merchants need to prepare after receiving payment notifications from Faspay.

{% tabs %}
{% tab title="Response" %}

<table><thead><tr><th>Parameter</th><th>Data Type</th><th width="73">M/O/C</th><th>Description</th></tr></thead><tbody><tr><td>trx_id</td><td>Alphanumeric (16)</td><td>M</td><td>Transaction ID (Issued/generated by Faspay (Media Indonusa))<br>Notes: Unique Transaction ID for 1 day or as long as it hasn't been paid and hasn't expired</td></tr><tr><td>merchant_id</td><td>Numeric (15)</td><td>M</td><td>Channel Code From Faspay</td></tr><tr><td>bill_no</td><td>Alphanumeric (32)</td><td>M</td><td>Order Number</td></tr><tr><td>response_code</td><td>Alphanumeric (2)</td><td>M</td><td>Response code</td></tr><tr><td>response_desc</td><td>Alphanumeric (50)</td><td>M</td><td>Response Description</td></tr><tr><td>response_date</td><td>Datetime</td><td>M</td><td>Response date</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample XML Response" %}

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

{% endtab %}

{% tab title="Sample JSON Response" %}

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

{% endtab %}
{% endtabs %}