标签：支付 标识 开始 注册 要求 浏览器 服务器 修改 逻辑
| # | 必要前提 | 说明 |
|---|---|---|
| 1 | 已有UID和Token。 | 注册账号，在“我的Paysapi”-“账号设置”-“API接口信息”中获取。 |
| 2 | 已上传支付宝，微信不设金额二维码各一张 | 可能用到的定额二维码多多益善。在“我的PaysApi”-“商品管理”中上传。 |
| 3 | 已开通套餐 | 在首页开通。未开通的账号，跳转进支付页会提示错误。 |
| 4 | 已安装APP，并按要求设置完毕。 | 安装链接 设置要求 |
有2种方法发起支付：1.获取json支付页信息，自定义支付页；2.跳转到我们支付页
https://pay.bbbapi.com/?format=json
说明：用curl的post方式传参数，并直接获取json返回值，显示在您自定义的支付页上。
https://pay.bbbapi.com/
使用方法：用表单post的方式，post参数并跳转到此网址，显示我们的支付页。
| # | 参数名 | 含义 | 类型 | 说明 |
|---|---|---|---|---|
| 1 | uid | 商户uid | string(24) | 必填。您的商户唯一标识，注册后在设置里获得。一个24位字符串 |
| 2 | price | 价格 | float | 必填。单位：元。精确小数点后2位 |
| 3 | istype | 支付渠道 | int | 必填。1：支付宝；2：微信支付 |
| 4 | notify_url | 通知回调网址 | string(255) | 必填。用户支付成功后，我们服务器会主动发送一个post消息到这个网址。由您自定义。不要urlencode。例：http://www.aaa.com/paysapi_notify |
| 5 | return_url | 跳转网址 | string(255) | 必填。用户支付成功后，我们会让用户浏览器自动跳转到这个网址。由您自定义。不要urlencode。例：http://www.aaa.com/paysapi_return |
| 6 | orderid | 商户自定义订单号 | string(50) | 必填。我们会据此判别是同一笔订单还是新订单。我们回调时，会带上这个参数。例：201710192541 |
| 7 | orderuid | 商户自定义客户号 | string(100) | 选填。我们会显示在您后台的订单列表中，方便您看到是哪个用户的付款，方便后台对账。强烈建议填写。可以填用户名，也可以填您数据库中的用户uid。例：xxx, xxx@aaa.com |
| 8 | goodsname | 商品名称 | string(100) | 选填。您的商品名称，用来显示在后台的订单名称。如未设置，我们会使用后台商品管理中对应的商品名称 |
| 9 | key | 秘钥 | string(32) | 必填。把使用到的所有参数，连Token一起，按参数名字母升序排序。把参数值拼接在一起。做md5-32位加密，取字符串小写。得到key。网址类型的参数值不要urlencode。 |
key的拼接顺序：如用到了所有参数，就按这个顺序拼接：goodsname + istype + notify_url + orderid + orderuid + price + return_url + token + uid
注意：Token在安全上非常重要，一定不要显示在任何网页代码、网址参数中。只可以放在服务端。计算key时，先在服务端计算好，把计算出来的key传出来。严禁在客户端计算key，严禁在客户端存储Token。key值必为小写
{
//提示给用户的文字信息，会根据不同场景，展示不同内容
"msg":"付款即时到账 未到账可联系我们",
"data":{
//二维码信息，如果没返回，说明存在错误，参考msg的信息。
//想展示二维码内容，可以qrcode值放到这个网址后面：http://mobile.qq.com/qrcode?url=
"qrcode":"HTTPS://QR.ALIPAY.COM/FKX08406GFWYYSF0YRNC10",
//支付渠道：1-支付宝；2-微信
"istype":"1",
//显示给用户的订单金额(一定要把这个价格显示在支付页上，而不是订单金额)
"realprice":0.05
},
//code目前只返回1。
"code":1,
//判断支付成功后，要同步跳转的URL
"url":"https://www.paysapi.com/"
}
用户付款成功后，我们会向您在发起付款接口传入的notify_url网址发送通知。您的服务器只要返回200状态，就表示回调已收到。如果返回状态不是200，我们会再尝试回调3次，每次间隔1分钟。（注意：避免网络不稳定重发通知导致重复充值，每个orderid只允许执行一次充值逻辑。）
| # | 参数名 | 含义 | 类型 | 说明 |
|---|---|---|---|---|
| 1 | paysapi_id | paysapi生成的订单ID号 | string(24) | 一定存在。一个24位字符串，是此订单在PaysApi服务器上的唯一编号 |
| 2 | orderid | 您的自定义订单号 | string(50) | 一定存在。是您在发起付款接口传入的您的自定义订单号 |
| 3 | price | 订单定价 | float | 一定存在。是您在发起付款接口传入的订单价格 |
| 4 | realprice | 实际支付金额 | float | 一定存在。表示用户实际支付的金额。一般会和price值一致，如果同时存在多个用户支付同一金额，就会和price存在一定差额，差额一般在1-2分钱上下，越多人同时付款，差额越大。 |
| 5 | orderuid | 您的自定义用户ID | string(100) | 如果您在发起付款接口带入此参数，我们会原封不动传回。 |
| 6 | key | 秘钥 | string(32) | 一定存在。我们把使用到的所有参数，连您的Token一起，按参数名字母升序排序。把参数值拼接在一起。做md5-32位加密，取字符串小写。得到key。您需要在您的服务端按照同样的算法，自己验证此key是否正确。只在正确时，执行您自己逻辑中支付成功代码。 |
key的拼接顺序：如用到了所有参数，就按这个顺序拼接：orderid + orderuid + paysapi_id + price + realprice + token
用户付款成功后，我们会在先通过上面的接口，通知您服务器付款成功，再过1-3秒后将用户跳转到您在发起付款接口传入的return_url网址。注：用Json方式发起支付的，不会有主动跳转。需要自行监控您的订单信息是否被我们异步回调接口修改成支付成功状态，发现您订单更新后，自行给用户显示支付成功。
| # | 参数名 | 含义 | 类型 | 说明 |
|---|---|---|---|---|
| 1 | orderid | 您的自定义单号 | string(50) | 一定存在。您可以通过此orderid在您后台查询到付款确实成功后，给用户一个付款成功的展示。 |
注意：请不要将此跳转认为是用户付款成功的判断条件，此行为极不安全。请根据我们的付款成功回调通知是否送到，来判断交易是否成功。
标签：支付 标识 开始 注册 要求 浏览器 服务器 修改 逻辑
原文地址：https://www.cnblogs.com/jingxuan-li/p/9559086.html
