统一下单接口地址:
https://pay.its500.com/order/createOrder
传参方式:Post
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,此字段可以判断这笔订单属于哪个用户创建(强烈建议填写)
|
3 |
paytype |
支付类型 |
string(255) |
选填。wx 代表微信支付 ali 代表支付宝支付 QQ 代表QQ支付 |
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.xxx.cn/20210309003047",
"zfbcode ": "http://zyphoto.xxx.cn/20210328224809",
"qrcode ": "alipayqr://platformapi/startapp?saId=10000007&qrcode=https%3A%2F%2Fqr.alipay.com%2Ffkx152655c8lyjz0qqxag7a",
"zfbuseridcode ": "https://www.xxx.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.代表QQ支付
|
6 |
other |
自定义信息 |
string(255) |
如果您统一下单接口带入此参数,我们会原封不动传回。 |
7 |
remarks |
备注 |
string(255) |
如果您统一下单接口带入此参数,我们会原封不动传回。 |
8 |
thirduid |
贵平台用户ID |
string(255) |
如果您统一下单接口带入此参数,我们会原封不动传回。 |
9 |
reurl |
自定义信息 |
string(255) |
如果您统一下单接口带入此参数,我们会原封不动传回。 |
10 |
wxcode |
您的微信收款码 |
string(255) |
如果您在站长付后台上传微信收款码,我们将会把收款码地址给您返回。 |
11 |
qqcode |
您的QQ收款码 |
string(255) |
如果您在站长付后台上传QQ收款码,我们将会把收款码地址给您返回。 |
12 |
zfbcode |
您的支付宝收款码 |
string(255) |
如果您在站长付后台上传支付宝收款码,我们将会把收款码地址给您返回。 |
13 |
qrcode |
拉起支付宝使用 |
string(255) |
用户点击拉起支付宝付款,此参数可以跳转到您的转账页面。 |
14 |
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版本太旧,下载新版即可解决 |