# Server CallBack / URL Notification Credit Card

Faspay systems provide callback server / URL notification credit card that runs automatically, which serves to notify the results of transaction / transaction status. Any changes in the transaction status faspay server, then automatically the status of the last transaction will also be communicated to the merchant server consistently.

If the merchant's transaction status changes, for example: merchant went into administration portal faspay system to change the status of the credit card transaction Authorize status to the status of a transaction with the capture or sales status (success) into the Void / refund. Faspay server then automatically sends information (HTTPS POST) changes the status to the merchant server via the URL notification which gives a chance to the administration portal faspay

<div align="center"><img src="/files/-MM0Zr2nR9esos5C4pKf" alt="Flow Server Callback"></div>

Here is a response from faspay parameters that will be sent to the merchant server:

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

<table><thead><tr><th width="196">Parameter</th><th width="134">Data Type</th><th width="93" align="center">M/O/C</th><th width="300">Description</th></tr></thead><tbody><tr><td>PAYMENT_METHOD</td><td>Integer(1)</td><td align="center">M</td><td>Indicates the payment mode used for this transaction.</td></tr><tr><td>TRANSACTION_TYPE</td><td>Integer(2)</td><td align="center">M</td><td>Return transaction type corresponding to the original request.</td></tr><tr><td>MERCHANT_ID</td><td>Varchar(30)</td><td align="center">M</td><td>Your Faspay Merchant ID.</td></tr><tr><td>TRANSACTION_ID</td><td>Varchar</td><td align="center">M</td><td>Transaction ID generated by Faspay when payment occur-Occur.</td></tr><tr><td>MERCHANT_TRANID</td><td>Varchar(100)</td><td align="center">M</td><td>Merchant’s own assigned transaction id as passed in from the request.</td></tr><tr><td>TXN_STATUS</td><td>Varchar(100)</td><td align="center">M</td><td>Transaction status from Faspay.<br>A – Authorized<br>S – Sales<br>C – Captured<br>CF – Capture Failed<br>F – Failed<br>E – Error<br>B – Blocked<br>N – Pending<br>V – Void</td></tr><tr><td>CUSTNAME</td><td>Varchar(120)</td><td align="center">M</td><td>Shopper’s name.</td></tr><tr><td>DESCRIPTION</td><td>Varchar(100)</td><td align="center">O</td><td>Transaction description as passed in from the request.</td></tr><tr><td>CURRENCY_CODE</td><td>Varchar(3)</td><td align="center">M</td><td>Indicate the currency of this transaction. Refer to Appendix I for Supported Currencies E.g. IDR, USD, SGD etc.</td></tr><tr><td>AMOUNT</td><td>Varchar(10)</td><td align="center">M</td><td>Transaction amount as passed in from the request.</td></tr><tr><td>TRAN_DATE</td><td>Varchar(19)</td><td align="center">C</td><td>Transaction date of when transaction is submitted to Faspay e-Payment. Date format in ‘DD-MM-YYYY hh:mm:ss’ e.g. 24-05-2006 08:24:23 In the event of error, this field may be empty.</td></tr><tr><td>EXCEED_HIGH_RISK</td><td>Varchar(3)</td><td align="center">C</td><td><p>Indicate whether the transaction fraud score exceeds the<br>threshold value set for high risk in merchant setting.<br>Possible values are:<br>• Yes = Transaction fraud risk exceed merchant high<br>risk threshold.</p><p>• No = Transaction fraud risk fall bellows the merchant<br>high risk threshold.</p></td></tr><tr><td>FRAUDRISKLEVEL</td><td>Integer(1)</td><td align="center">C</td><td>Indicate fraud risk level. Value as follow:<br>-1 : Error or not in used.<br>0 : Very low risk<br>1 : Low risk<br>2 : Medium risk<br>3 : High risk<br>4 : Very high risk<br>In the event of error, this field may be empty.</td></tr><tr><td>FRAUDRISKSCORE</td><td>Numeric</td><td align="center">C</td><td>Fraud risk score in two decimal values.</td></tr><tr><td>IS_BLACKLISTED</td><td>Varchar(5)</td><td align="center">C</td><td>Indicate whether the transaction is blacklisted. Value is ‘Yes’ or ‘No’ In the event of error, this field may be<br>empty.</td></tr><tr><td>CARD_TYPE</td><td>Varchar(1)</td><td align="center">M</td><td>Indicates the card type used.<br>MasterCard = M<br>Visa = V<br>JCB = J<br>AMEX = A</td></tr><tr><td>CARD_NO_PARTIAL</td><td>Varchar(20)</td><td align="center">C</td><td>Returns first 6 and last 4 digits of credit card. E.g.: 455555XXXXXX1234 In the event of error, this field may be empty.</td></tr><tr><td>CARD_NAME</td><td>Varchar(100)</td><td align="center">C</td><td>Name on the Credit Card.</td></tr><tr><td>BANK_RES_CODE</td><td>Varchar(20)</td><td align="center">C</td><td>Response code or error code from bank. In the event of error, this field may be empty.</td></tr><tr><td>BANK_RES_MSG</td><td>Varchar(20)</td><td align="center">C</td><td>Response code or error code from bank. In the event of error, this field may be empty.</td></tr><tr><td>ERR_CODE</td><td>Varchar(10)</td><td align="center">M</td><td>Bank description on the response based on original response from bank. In the event of error, this field may be empty.</td></tr><tr><td>ERR_DESC</td><td>Varchar(250)</td><td align="center">M</td><td>Error Code returns from Faspay . If the transaction is successful, the value will be 0. Any value other than 0 will indicate that the transaction is not successful.</td></tr><tr><td>USR_CODE</td><td>Varchar(4)</td><td align="center">C</td><td>Error description from Faspay based on the ERR_CODE.</td></tr><tr><td>USR_MSG</td><td>Varchar(200)</td><td align="center">C</td><td>User Code returns from Faspay e-Payment. A user code will be used to indicate the appropriate action to be taken by shopper according to different bank response code obtained. In the case of pending status, this value is will an empty value.</td></tr><tr><td>MPARAM1</td><td>Varchar(200)</td><td align="center">O</td><td><p>Additional parameter the merchant wish to receive back as response for processing.</p><p>This value is stored by Faspay e-Payment.</p></td></tr><tr><td>MPARAM2</td><td>Varchar(200)</td><td align="center">O</td><td><p>Additional parameter the merchant wish to receive back as response for processing.</p><p>This value is stored by Faspay e-Payment.</p></td></tr><tr><td>SIGNATURE</td><td>Varchar(40)</td><td align="center">M</td><td>Transaction signature of request for data integrity check.</td></tr></tbody></table>
{% endtab %}

{% tab title="Sample Request" %}

```php
{
 "PAYMENT_METHOD": "1",
 "TRANSACTION_TYPE": "1",
 "MERCHANT_ID": "auto_store",
 "TRANSACTION_ID": "477DC7E5-D26B-46C5-AF39-61D8B47310AB",
 "MERCHANT_TRANID": "AGS028",
 "TXN_STATUS": "S",
 "CUSTNAME": "Agus",
 "DESCRIPTION": "Make+Payment",
 "CURRENCY_CODE": "IDR",
 "AMOUNT": "20000.00",
 "TRAN_DATE": "2024-09-05+15%3A46%3A48",
 "EXCEED_HIGH_RISK": "No",
"FRAUDRISKLEVEL":1,
"FRAUDRISKSCORE":9.36,
"IS_BLACKLISTED":"No",
 "CARD_TYPE": "V",
 "CARD_NO_PARTIAL": "444000xxxxxx0010",
 "CARD_NAME": "Agus+Priyono",
 "BANK_RES_CODE": "00",
 "BANK_RES_MSG": "Approved",
 "ERR_CODE": "0",
 "ERR_DESC": "No+error.",
 "USR_CODE": "101",
 "USR_MSG": "Transaction+approved",
 “MPARAM1”: “123abc456def789ghij”,
 “MPARAM2”: “987abc654def321ghij”,
 "SIGNATURE": "179FC43716AD168F249AF55241213A7A652BE255"
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.faspay.co.id/merchant-integration/api-reference-1/credit-card-transaction/additional-api-integration/server-callback-url-notification-credit-card-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
