對接方式如下
統一下單(必用接口)
統一下單接口位址:
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 | 您的測試環境有問題。請登入 |