post https://api.fiuu.com/RMS/API/gate-query/index.php
This will trigger a query to the payment channel or bank status server and there are cases that bank status server is not in-sync with its payment server that might give different results, that leads to a defer update and will trigger a callback from PG server, once the status is synced and changed.
Note : No result available for transactions more than 1 day or 24 hours.
Response
| Variable / Parameter | Type Format / Max Length | Description / Example |
|---|---|---|
| Amount | 2 decimal points numeric value | The payment amount |
| TranID | integer, 20 digits | Unique transaction ID for tracking purpose. |
| Domain | alphanumeric, 32 chars | Merchant ID in PG system. |
| Channel | alphanumeric, 100 chars | Payment via Channel |
| VrfKey | 32 chars hexadecimal string | This is the data integrity protection hash string. |
| StatCode | string of 2-digit numeric | 00 = Success, 11 = Failure, 22 = Pending |
| StatName | alphanumeric | Success: captured, settled, authorized, Failure: failed, cancelled, chargeback, release, reject/hold, blocked, ReqCancel, ReqChargeback, Pending: Pending, Unknown |
| Currency | 3 chars ISO-4217 currency code | The payment currency. E.g. MYR, USD, EUR, AUD, SGD, CNY, IDR |
| ErrorCode | alphanumeric | Error code defined by channel for failed transactions only |
| ErrorDesc | alphanumeric | Error description defined by channel for failed transactions only |
| ProcessorResponseCode | alphanumeric | Authorization response code |
| ProcessorCVVResponse | alpha | Credit Card validation response code |
| SchemeTransactionID | alphanumeric | Transaction ID provided by CC Schemes. |
| MerchantAdviceCode | numeric | MasterCard issuers use the Merchant Advice Code (MAC) in authorization request responses to communicate with merchants about a cardholder's account |
| ECI | numeric | Electronic Commerce Indicator (ECI) is a value returned by Directory Servers (namely Visa, MasterCard, MyDebit, JCB, and American Express) indicating the outcome of authentication attempted on transactions enforced by 3DS |
| 3DSVersion | alphanumeric | Version of the 3DS use to authenticate the transaction |
| ACSTransactionID | alphanumeric | ACS transaction identifier |
| 3DSTransactionID | alphanumeric | 3DS transactions identifier |
Formula of skey & VrfKey
skey = md5({txID}{domain}{verify_key}{amount})
VrfKey = md5({Amount}{secret_key}{Domain}{TranID}{StatCode})Example of Direct Status Requery for PHP
<?php
$skey = md5($txID . $domain. "xxxxxxxxxx" . $amount);
//Replace xxxxxxxxxx with Verify Key
echo "<a
href='https://api.fiuu.com/RMS/API/gate-query/index.php?amount=3899&txID=65234&domain=shopA&skey=e1c4c60c99116fffc3ce77bd5fd0f7b1'>
Check payment status for tran ID 65234 </a>";
?>