查詢轉帳訂單

商家透過此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

範例:

Last updated