API Reference

創建轉帳訂單

商家通過轉帳API發起轉帳請求，PassToPay支付網關將根據請求信息創建轉帳訂單。

請求路徑 : api/transferOrder

請求方式 : POST

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

請求參數：

參數描述範例
mchNo必填。商家編號，在管理後台可查看。M1621873433953
appId必填。商家編號，在管理後台可查看。60cc09bce4b0f1c0b83761c9
mchOrderNo必填。商家唯一的轉帳訂單編號20160427210604000490
entryType必填
入账方式：
BANK_CARD-银行卡		BANK_CARD
amount必填。轉帳金額，單位分100
currency必填。三位數貨幣代碼，人民幣：cnycny
accountNo必填
收款账号，如果入账方式是银行卡则填银行卡号		029312331233322312323
accountName如果填寫，姓名就會被驗證，否則不會被驗證。張三
bankName收款帳號對應的銀行名稱中國工商銀行
clientIp必填用戶端 IPV4 位址210.73.10.148
transferDesc轉帳備註資訊，固定值: 00
notifyUrl轉帳完成後會通知該URL。只有當這個值被傳遞時才會發起通知。https://www.passtopay.com/notify.htm
channelExtra特定渠道发起的额外参数,json格式字符串。（注意不要使用对象，避免排序问题验签失败）{"custNo":"客戶唯一編號","telNo":"大陸手機號碼，無區號","cardNo":"身分證號碼",bankCode:"銀行編碼列表2"}
extraParam商家擴充參數，回調時原樣返回134586944573118714
reqTime必填。請求API時間，13位時間戳1622016572190
version必填。版本號，當前版本：1.11.1
sign必填。簽名值，詳見請求簽名C380BEC2BFD727A4B6845133519F3AD6
signType必填。簽名類型，目前僅支援MD5方式MD5
custNo必填.客戶唯一編號（V1.1.0 新增）C2312110001

请求範例：

{
  "entryType": "BANK_CARD",
  "amount": 1,
  "mchOrderNo": "M17223190411769999",
  "transferDesc": "0",
  "reqTime": "1722319041176",
  "version": "1.1",
  "appId": "65f2a186d1ba69d7f90d9820",
  "accountName": "张三",
  "accountNo": "6216698100001726141",
  "clientIp": "128.3.211.155",
  "signType": "MD5",
  "currency": "CNY",
  "custNo": "UID86000108",
  "mchNo": "M1702966122",
  "channelExtra": "{\"telNo\":\"13812341234\",\"cardNo\":\"141000212123333333\",\"bankCode\":\"CCB\"}",
  "sign": "F752841EA3EFCE5FC67366B38906E435"
}

签名字符串范例：

accountName=张三&accountNo=6216698100001726141&amount=1&appId=abcd1234&channelExtra={"telNo":"13812341234","cardNo":"141000212123333333","bankCode":"CCB"}&clientIp=128.3.211.155&currency=CNY&custNo=UID86000108&entryType=BANK_CARD&mchNo=M1702966122&mchOrderNo=M1722
3190411769999&reqTime=1722319041176&signType=MD5&transferDesc=0&version=1.1

回應參數：

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

Data 參數:

參數描述範例
transferId必填。返回轉帳單號T202108161731281310004
mchOrderNo必填。返回商家傳入的轉帳訂單編號mho1624007315478
amount必填。返回商家傳入的轉帳訂單金額100
state必填。傳輸狀態
0：訂單生成
1：傳輸正在進行中
2：轉帳成功
3：傳輸失敗
4：轉帳關閉		2
accountNo必填收款账号0293123312333
accountName收款帳號所屬人姓名張三

範例：

{
    "code": 0,
    "data": {
        "accountName": "Zhang San",
        "amount": 11,
        "accountNo": "0293123312333",
        "mchOrderNo": "1629106288",
        "state": 2,
        "transferId": "T202108161731281310004"
    },
    "msg": "SUCCESS",
    "sign": "195BF6F112386F7FC8EA2AA7EECA1D33"
}