查詢轉帳訂單

商家透過此API查詢轉帳訂單，PassToPay會傳回最新的訂單信息。

請求路徑 : api/transfer/query

請求方式 : POST

請求類型 : application/json or application/x-www-form-urlencoded

---

請求參數

參數	描述	範例
mchNo	必填。商家號碼	M1621873433953
appId	必填。應用程式 ID	60cc09bce4b0f1c0b83761c9
transferId	必填。支付中心產生的轉帳訂單號，與mchOrderNo可以一起傳遞	T20160427210604000490
mchOrderNo	必填。商家產生的轉帳訂單號，兩者之一與transferId一起傳即可	20160427210604000490
reqTime	必填。請求API時間，13位時間戳	1622016572190
version	必填。版本號，固定：1.0	1.0
sign	必填。簽名值，詳見請求簽名	C380BEC2BFD727A4B6845133519F3AD6
signType	必填。簽名類型，目前僅支援MD5方式	MD5

範例:

{
"appId":"60cc3ba74ee0e6685f57eb1e",
"sign":"D3C0CC231F3FC3D033650699BA099B39",
"signType":"MD5",
"reqTime":"1629106457",
"transferId":"T202108121543441860003",
"mchNo":"M1623997351",
"version":"1.0"
}

回應參數：

參數	描述	範例
code	必填 0：處理成功， other：處理錯誤，具體見錯誤碼	0
msg	具體錯誤原因，如：簽名失敗、參數格式校驗錯誤	Signing failure
sign	對data中的資料進行簽名。如果資料為空，則不會傳回。	CCD9083A6DAD9A2DA9F668C3D4517A84
data	返回訂單數據，json格式數據	{}

Data Parameters:

參數	描述	範例
mchNo	必填。商家號碼	M1621873433953
appId	必填。應用程式 ID	60cc09bce4b0f1c0b83761c9
mchOrderNo	必填。商家產生的轉帳訂單編號	20160427210604000490
transferId	必填。支付中心產生的轉帳單號	T20160427210604000490
amount	必填。轉帳金額，單位分	100
currency	必填。三位數貨幣代碼，人民幣：cny	cny
ifCode	必填 wxpay-微信官方接口 ; alipay-支付宝官方接口; aliaqfpay-支付宝安全发接口	wxpay
entryType	必填 入账方式： WX_CASH-微信零钱; ALIPAY_CASH-支付宝转账; BANK_CARD-银行卡	20160427210604000490
state	必填。傳輸狀態 0：訂單生成 1：傳輸正在進行中 2：轉帳成功 3：傳輸失敗 4：傳輸關閉	2
accountNo	必填 wxpay：openID，alipay：登入帳號	o6BcIwvTvIqf1zXZohc61biryWik
accountName	如果填寫，姓名就會被驗證，否則不會被驗證。	張三
bankName	目前僅供記錄	中國工商銀行
transferDesc	轉帳備註資訊	測試轉帳
channelOrderNo	對應通道的調撥單號	20160427210604000490
errCode	通道返回錯誤碼	1002
errMsg	通道回傳錯誤描述	134586944573118714
extraParam	商家擴充參數，回呼時原樣返回	134586944573118714
createdAt	必填。訂單建立時間，13位時間戳	1622016572190
successTime	轉帳成功時間，13位時間戳	1622016572190

範例:

{
    "code": 0,
    "data": {
        "accountNo": "o6BcIwvTvIqf1zXZohc61biryWik",
        "amount": 1,
        "appId": "6113805e42020495c62bd4cb",
        "createdAt": 1628818820011,
        "currency": "CNY",
        "entryType": "WX_CASH",
        "errCode": "OPENID_ERROR",
        "errMsg": "openid mismatch with appid",
        "ifCode": "wxpay",
        "mchNo": "M1623997351",
        "mchOrderNo": "1628818820",
        "state": 3,
        "transferDesc": "test",
        "transferId": "T202108130940200100001"
    },
    "msg": "SUCCESS",
    "sign": "A262DBD3D6182E8A0AEC90EF820F2A5A"
}