跳至主要內容

查詢


可以查詢消費交易和退款交易的信息。

相關信息

{domain}/Servlet/JSAPIService.do

https://vmp.eftpay.com.cn/VMP/Servlet/JSAPIService.do

名稱類型描述要求
serviceString接口名稱,詳見 支援的service
querytypeString(30)查詢類型,固定:OUT_TRADE
out_trade_noString(28)商戶訂單號
refund_noString(28)商戶退款號,查詢退款交易時傳入
user_confirm_keyString(12)用戶Key,由 eftPay 提供
paytypeString(6)支付類型,詳見 支援的paytype
buyertypeString(7)設備類型
iosandroidothers
payment_typeString(20)錢包類型,詳見 支援的payment_type
timeString時間,格式:yyyyMMddHHmmss
signString(64)簽名

提示

當 refund_no 不填或者為""時,返回基於 out_trade_no 的訂單信息,即 trade_status 為訂單消費訂單的狀態;否則返回基於 refund_no 的退款信息,即 trade_status 為退款訂單的狀態。

查看支援的 service 以及其對應的 paytype 和 payment_type

以下是 service、paytype 和 payment_type 三者之間的對應關係

servicepaytypepayment_type描述
service.alipay.qrcode.QueryAlipayALIPAYCN
ALIPAYHK
ALIPAYBOTH
支付寶 qrcode Query 接口
service.wechat.qrcode.QueryWeChatWECHATCN
WECHATHK
微信 qrcode Query 接口
service.atome.v1.qrcode.QueryATOMEATOMEATOME qrcode Query 接口
service.unionpay.qrcode.csb.QueryUnionPayUNIONPAY銀聯 qrcode Query 接口
api.service.gbpay.qrcode.cash.QueryGBPAYGBPAYGBPAY qrcode Query 接口
service.payme.qrcode.QueryPAYMEPAYMEPAYME qrcode Query 接口
service.fps.qrcode.QueryFPSFPSFPS qrcode Query 接口

名稱類型描述要求
return_statusString(3)返回狀態碼,代表。注:此參數不可作為交易狀態是否成功的判斷
其他狀態碼見 附錄3
return_charString(100)返回說明,可能會變化,不能作條件判斷
return_status 大於 00 時返回
timeString時間,格式:yyyyMMddHHmmss
return_status >= 00 時返回
signString(64)簽名
return_status >= 00 時返回

名稱類型描述要求
out_trade_noString(28)商戶訂單號
extra_trade_noString(28)商戶退款號,查詢退款返回
eftpay_trade_noString(28)依付得訂單號
trade_statusString(32)交易狀態,見 附錄2
user_confirm_keyString(12)用戶Key,由 eftPay 提供
trade_typeString(10)訂單類型,見 附錄4
buyer_idString(30)用戶標識
tidString(20)終端號,當消費請求有送的時候返回
transaction_idString(64)支付提供方單號
payment_typeString(8)錢包類型
trade_timeString交易時間,格式:yyyy-MM-dd HH:mm:ss
transaction_amountString(8)交易金額。
查詢消費時為消費金額;查詢退款時為退款金額
currencyString(10)貨幣
original_amountString(8)原交易金額,查詢退款返回
rateString(10)匯率,GBPAY 類型返回
actual_total_feeString(12)實際支付金額,GBPAY 類型返回
actual_total_fee_typeString(10)實際支付貨幣,GBPAY 類型返回
payment_amountString(12)商家實收款金額,UnionPay 類型返回
cost_amountString(12)用戶支付的金額,UnionPay 類型返回
uplan_discountString(12)Uplan 優惠金額,UnionPay 類型返回
amount_discountString(12)立減優惠金額,UnionPay 類型返回

{
    "service": "service.alipay.qrcode.Query",
    "user_confirm_key": "12345678",
    "out_trade_no": "201908241040035",
    "sign": "24db1adc94b18a416796695a3062398bf3908bff7647da4948b769bf118dff87",
    "time": "20190824104052",
    "paytype": "WeChat",
    "payment_type": "WECHATCN",
    "buyertype": "ios",
    "querytype": "OUT_TRADE"
}

{
    "return_status": "00",
    "return_char": "",
    "sign": "6077b275107676aac219cb38d7970a8f3de607f47d6baa6320f337a4ca1358e2",
    "time": "20190824104135",
    "out_trade_no": "201908241040035",
    "eftpay_trade_no": "08520005269190824104101935",
    "trade_status": "TRADE_SUCCESS",
    "user_confirm_key": "12345678",
    "trade_type": "SALE",
    "buyer_id": "2088012867786450",
    "tid": "tid123",
    "transaction_id": "2019082422001486450540740143",
    "payment_type": "WECHATCN",
    "trade_time": "2019-08-24 10:41:25",
    "transaction_amount": "0.02",
    "currency": "HKD",
    "original_amount": "10.01"
}