天天看點

站長付個人微信支付寶收款系統如何對接?

對接方式如下

統一下單(必用接口)

統一下單接口位址:

https://admin.zhanzhangfu.com/order/createOrder      

傳參方式:Post

Header頭資訊:Payment-Key=AppKey(“API秘鑰設定”擷取AppKey)

Header頭資訊:Payment-Secret=AppSecret(“API秘鑰設定”擷取AppSecret)

Header頭資訊:Content-Type=application/x-www-form-urlencoded(參數已傳但還出現參數為空,此header傳上再試)

請求參數:

# 參數名 含義 類型 說明
1 price 價格 float 必填。機關:元。精确小數點後2位(注意:金額必須>=1元、金額必須>=1元、金額必須>=1元)
2 name 商品名稱 string(100) 必填。您的商品名稱,用來顯示在背景的訂單名稱。
3 reurl 跳轉url string(255) 選填。例如用來判斷訂單支付完成後跳轉的網頁
4 thirduid 第三方使用者ID string(255) 選填。貴平台的使用者ID,此字段可以判斷這筆訂單屬于哪個使用者建立(強烈建議填寫)
5 remarks 訂單備注 string(255) 選填。擴充業務可以使用
6 other 訂單其他資訊 string(255) 選填。擴充業務可以使用(不想編寫收銀台頁面?點選詳解)
7 callbackurl 回調位址 string(255) 選填。不穿則通知預設位址,多站點時使用,用來通知指定位址(使用場景您有多個網站時。注意:此位址必須加入到“背景”-“API回調接口”)

注意:AppKey和AppSecret在安全上非常重要,一定不要顯示在網頁代碼中。建議放在服務端。支付時必須讓使用者填寫我們返給您的 “price” 金額,否則會造成漏單,錢收到了訂單還是提示未支付,有疑問?點選了解

請求的傳回值:

{ "msg": "下單成功", "other": "", "code": "10001", "orderId": "oderpay-7ae379d1-e4c1-4acd-8d9a-584a208b28b7", "price": "99.13", "name": "開通超級VIP", "reurl": "", "thirduid": "15811111111", "originalprice ": "100", "remarks ": "", "wxcode ": "http://zyphoto.itluntan.cn/20210309003047", "zfbcode ": "http://zyphoto.itluntan.cn/20210328224809", "qrcode ": "alipayqr://platformapi/startapp?saId=10000007&qrcode=https%3A%2F%2Fqr.alipay.com%2Ffkx152655c8lyjz0qqxag7a", "zfbuseridcode ": "https://admin.zhanzhangfu.com/common/zfbuserid?zfbuserid=2088212200290635&price=1000.00", }       

使用者付款成功後,我們會向您綁定的回調位址發送POST請求通知您,點我設定回調位址

向貴平台回調位址接口發送資料格式如下

{
        "code": 10001,
        "msg": "回調成功",
        "other": "",
        "orderId": "oderpay-445b1306-6f50-48dd-99c1-9a704108f8ff",
        "price": "99.97",
        "originalprice":"100",
        "name": "開通超級VIP",
        "reurl": "",
        "thirduid": "15811111111",
        "paytype": "0",
        "remarks": ""
}       

傳參方式:Post

參數詳解:

# 參數名 含義 類型 說明
1 orderId 站長付生成的訂單ID号 string 一定存在。此訂單在站長付伺服器上的唯一編号
2 originalprice 訂單原價 string 一定存在。您統一下單接口傳入的訂單價格
3 price 實際支付金額 string 一定存在。(使用者必須)您統一下單接口傳入的訂單價格經過我們1元内随機減後所生成的,例如:您統一下單時傳入100元,使用者支付時可能是99.98元
4 name 訂單名稱 string 一定存在。是您在發起付款接口傳入的訂單名稱
5 paytype 支付類型 int 一定存在。0.代表微信,1.代表支付寶
6 other 自定義資訊 string(255) 如果您統一下單接口帶入此參數,我們會原封不動傳回。
7 remarks 備注 string(255) 如果您統一下單接口帶入此參數,我們會原封不動傳回。
8 thirduid 貴平台使用者ID string(255) 如果您統一下單接口帶入此參數,我們會原封不動傳回。
9 reurl 自定義資訊 string(255) 如果您統一下單接口帶入此參數,我們會原封不動傳回。
10 wxcode 您的微信收款碼 string(255) 如果您在站長付背景上傳微信收款碼,我們将會把收款碼位址給您傳回。
11 zfbcode 您的支付寶收款碼 string(255) 如果您在站長付背景上傳支付寶收款碼,我們将會把收款碼位址給您傳回。
12 qrcode 拉起支付寶使用 string(255) 使用者點選拉起支付寶付款,此參數可以跳轉到您的轉賬頁面。
13 zfbuseridcode 使用者付款無需輸入金額 string(255) 如果在背景您配置了此參數,使用者支付寶掃碼付款時不用手動輸入金額

錯誤碼:

編号 描述 解決方案
10001 代表成功 所有接口傳回10001說明成功
10002 下單失敗,支付金額有誤 機關“元”
10003 下單失敗,支付金額格式錯誤 請檢查金額是否是float類型,“1”代表一進制 機關“元” 正确實列:99.98、100
10004 下單失敗,支付金額必須大于等于1元 金額必須大于等于1元
10005 下單失敗,AppKey或者AppSecret不合法 請檢查AppKey或者AppSecret是否正确,登入背景,“API秘鑰設定” 中擷取。
10006 下單失敗,商戶不存在,請聯系客服 請檢查AppKey是否正确,登入背景,“API秘鑰設定” 中擷取。
10007 下單失敗,您的賬戶被當機,請聯系客服 請聯系客服
10008 下單失敗,您的賬戶餘額不足 說明您的賬戶“接口回調次數”不足,自行充值
10009 下單失敗,您還未設定回調接口 請登入背景-API回調接口,進行設定
10010 下單失敗,回調接口異常 請登入背景-API回調接口,進行核對
10021 回調失敗,Money為空 用戶端問題,APP版本太舊,下載下傳新版即可解決
10022 下單失敗,請在您綁定的域名或者IP内下單(支付要在您綁定的域名或者IP執行),登入背景設定域名ip 您的測試環境有問題。請登入