Yuansfer DOCS
Search
⌃K

Transaction Query

post
https://mapi.yuansfer.com/app-data-search/v3
/tran-query
TranQuery
Response
Parameter
Type
Description
result
object
The result object.
ret_msg
string
The response return message.
ret_code
string
The response return code. For more details, see here.
Result Object
Parameter
Type
Description
transactionNo
string
The Transaction ID in the Yuansfer system.
reference
string
The Invoice Number of the transaction in the merchant’s system.
amount
number
The transaction amount.
status
string
The status of the transaction.
currency
string
The supported transaction currency is "USD", "CNY".
settleCurrency
string
The supported settlement currency is "USD", "CNY".
transactionType
string
The type will be either "payment" or "refund".
RefundInfo Object
Parameter
Type
Description
refundTransactionId
string
The ID of the refund transaction in the Yuansfer system.
refundReference
string
The ID of the refund transaction in the merchant’s system.
refundAmount
string
The transaction refund amount. This parameter will be returned only when the payment order contains a 'Amount'.
refundRmbAmount
string
The transaction refund amount of CNY. This parameter will be returned only when the payment order contains a 'rmbAmount'.
currency
string
The supported transaction currency is "USD", "CNY".
settleCurrency
string
The supported settlement currency is "USD", "CNY".
cURL
PHP
Java
Go
curl -XPOST -H "Content-type: application/json" -d '{
"merchantNo": "200043",
"storeNo": "300014",
"transactionNo": "297553638300708562",
"verifySign": "0df745088d7202a6d186596acdc82c6a"
}' 'https://mapi.yuansfer.com/app-data-search/v3/tran-query'
<?php
function securepayReferenceQuery()
{
$url = 'https://mapi.yuansfer.com/app-data-search/v3/tran-query';
$token = '5cbfb079f15b150122261c8537086d77a';
$params = [
'merchantNo' => '200043',
'storeNo' => '300014',
'reference' => 'test2018070101'
];
ksort($params, SORT_STRING);
$str = '';
foreach ($params as $k => $v) {
$str .= $k . '=' . $v . '&';
}
$params['verifySign'] = md5($str . md5($token));
echo 'verifySign:', $params['verifySign'];
echo "\n";
$ch = curl_init($url);
curl_setopt_array($ch, array(
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => false,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($params),
));
$result = curl_exec($ch);
curl_exec($ch);
echo $result;
echo "\n";
return json_decode($result, true);
}
securepayReferenceQuery();
?>
public class SecurepayReferenceQueryTest {
public static final String TEST_URL = "https://mapi.yuansfer.yunkeguan.com"; //Testing domain
public static final String PROD_URL = "https://mapi.yuansfer.com"; //Production domain
public static final String YUANSFER_TOKEN = "5cbfb079f15b150122261c8537086d77a";
public static void main(String[] args) {
YuansferVerifySignHelper helper = new YuansferVerifySignHelper();
YuansferSecurepayQueryDto dto = paramSetting();
Map<String, Object> params = ReflectionUtils.convertBean2MapIgnoreNullVal(dto, new String[]{"serialVersionUID"});
String verifySign = helper.getYuansferVerifySign(params, YUANSFER_TOKEN); //verifySign
params.put("verifySign", verifySign);
String url = TEST_URL + "/app-data-search/v3/tran-query";
String ret = HttpClientUtils.post(url, null, params);
System.out.println(ret);
}
public static YuansferSecurepayQueryDto paramSetting() {
YuansferSecurepayQueryDto dto = new YuansferSecurepayQueryDto();
dto.setMerchantNo("200043"); //The merchant NO.
dto.setStoreNo("300014"); //The store NO.
dto.setReference("20180126162433");
return dto;
}
}
func query(t *table) {
req := yuan.Query{
MerchantNo: "200043", //customer The merchant NO.
StoreNo: "300014",
Reference: "original sequence No.", //sequence number of customer system
}
//TO CALL VERIFYSIGN
resp, err := req.PostToYuansfer(yuansferToken)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(resp)
}