上线注意事项
开通产线环境需要满足以下两个条件:1. KYC认证通过;2. 合同签订完成。
一、测试验收
测试联调完成后,建议按下述用例进行自测。
1. 支付状态获取
a.配置回调地址
请确认是否正确配置回调地址,目前支持接口传入和平台设置两种配置方式。查看配置方法
- 正确设置和使用回调地址,可以提高获取支付结果的效率,及时获取支付状态变更信息。
b.获取支付状态
请确认是否正确理解和处理PayerMax所给出的支付状态。
- 订单的支付状态,可通过异步回调和主动查询获知。
- 若支付状态理解错误,可能会导致资金损失。
- 以下为支付状态说明: -- status=0 支付中(非支付终态) 用户正在支付:需要等待PayerMax的回调通知,或者通过查询取得交易的最新结果。 -- status=1 交易成功 用户已支付成功:请给用户提供所购买的服务,如充值、发货、会员等。 -- status=2 交易失败 用户支付失败:请按支付失败处理,该笔订单的状态不会再流转为成功。
2.信息安全保证
a.订单信息存储
请确认订单信息是否存储在服务端,避免用户或订单数据丢失。
- 建议将用户的支付数据存储在服务端,可保证在如下场景下用户的支付数据不会丢失。 -- 覆盖安装,导致订单数据丢失 -- 用户退出或关闭APP,导致订单数据丢失 -- 清除APP缓存,导致订单数据丢失
b.用户信息安全
请保证所传入的用户ID(custId)的唯一性,避免泄露用户的个人信息。
- 收银台会根据custId推荐该用户曾经支付成功的支付方式。
- 如果商户侧无法保证custID唯一性,将会导致用户看到他人的支付信息。
二、产线商户号、密钥和回调地址
1. 商户号
正式环境和测试环境的商户号是相同的。 请登录商户平台,进入[设置服务] - [信息管理]页面,查看商户号。
2. 获取产线密钥
正式环境的密钥需要重新生成。 请登录商户平台,进入[设置服务] - [开发参数]页面,在[正式环境]标签页下,生成正式环境的商户密钥。
3. 设置回调地址
正式环境的回调地址需要重新设置。 PayerMax支持两种方式设置回调地址:
- 请登录商户平台,进入[设置服务] - [开发参数]页面,在[正式环境]标签页下,配置正式环境的回调地址。
- 在下单时传入回调地址。 注意:若您传入的回调地址和商户平台配置的回调地址有冲突,以您传入的回调地址为准。
三、请求地址替换
正式环境的请求地址和测试环境不同,请注意切换。
1. 产线请求地址
服务 | 请求地址 |
---|---|
收款服务 | https://pay-gate.payermax.com/aggregate-pay-gate/api/gateway |
付款服务 | https://pay-gate.payermax.com/aggregate-pay-gate/api/gateway/v2 |
2.切产线注意事项(收款服务):
- API切产线注意事项详见:切产线注意事项(API).pdf