Direct Status Requery

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.

Request

URL: https://api.fiuu.com/RMS/API/gate-query/index.php

Method: POST or GET

Variable / Parameter	Type Format / Max Length	Description / Example
amount	2 decimal points numeric value	The payment amount
txID	integer, 20 digits	Unique transaction ID for tracking purpose.
domain	alphanumeric, 32 chars	Merchant ID in PG system.
skey	32 chars hexadecimal string	This is the data integrity protection hash string.
url	optional, URL for POST response	The URL to receive POST response from PG
type	optional, 1-digit integer, obsoleted in new API sets	0 = plain text result (default) 1 = result via POST method 2 = JSON text result

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 for skey

md5( {txID}{domain}{verify_key}{amount} )

Formula for 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>”;

?>

Example of response

Updated 9 days ago