創建轉帳訂單

商家通過轉帳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	必填。三位數貨幣代碼，人民幣：cny	cny
accountNo	必填收款账号，如果入账方式是银行卡则填银行卡号	029312331233322312323
accountName	如果填寫，姓名就會被驗證，否則不會被驗證。	張三
bankName	收款帳號對應的銀行名稱	中國工商銀行
clientIp	必填用戶端 IPV4 位址	210.73.10.148
transferDesc	轉帳備註資訊，固定值: 0	0
notifyUrl	轉帳完成後會通知該URL。只有當這個值被傳遞時才會發起通知。	https://www.passtopay.com/notify.htm
channelExtra	特定渠道发起的额外参数,json格式字符串。（注意不要使用对象，避免排序问题验签失败）	{"custNo":"客戶唯一編號","telNo":"大陸手機號碼，無區號","cardNo":"身分證號碼",bankCode:"銀行編碼列表2"}
extraParam	商家擴充參數，回調時原樣返回	134586944573118714
reqTime	必填。請求API時間，13位時間戳	1622016572190
version	必填。版本號，當前版本：1.1	1.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"
}