API Reference

查詢轉帳訂單

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

請求路徑 : api/transfer/query

請求方式 : POST

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

請求參數

參數描述範例
mchNo必填。商家號碼M1621873433953
appId必填。應用程式 ID60cc09bce4b0f1c0b83761c9
transferId必填。支付中心產生的轉帳訂單號，與mchOrderNo可以一起傳遞T20160427210604000490
mchOrderNo必填。商家產生的轉帳訂單號，兩者之一與transferId一起傳即可20160427210604000490
reqTime必填。請求API時間，13位時間戳1622016572190
version必填。版本號，固定：1.01.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必填。應用程式 ID60cc09bce4b0f1c0b83761c9
mchOrderNo必填。商家產生的轉帳訂單編號20160427210604000490
transferId必填。支付中心產生的轉帳單號T20160427210604000490
amount必填。轉帳金額，單位分100
currency必填。三位數貨幣代碼，人民幣：cnycny
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"
}