统一下单接口

准备工作 统一下单接口 订单查询接口 demo下载 傻瓜版接入 易支付/码支付接入
统一下单(必用接口)
统一下单接口地址:
https://user.payking.app/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,此字段可以判断这笔订单属于哪个用户创建(强烈建议填写)
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 PayKing生成的订单ID号 string 一定存在。此订单在PayKing服务器上的唯一编号
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) 如果您在PayKing后台上传微信收款码,我们将会把收款码地址给您返回。
11 qqcode 您的QQ收款码 string(255) 如果您在PayKing后台上传QQ收款码,我们将会把收款码地址给您返回。
12 zfbcode 您的支付宝收款码 string(255) 如果您在PayKing后台上传支付宝收款码,我们将会把收款码地址给您返回。
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版本太旧,下载新版即可解决