Skip to content

上线注意事项

开通产线环境需要满足以下两个条件: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. 请登录商户平台,进入[设置服务] - [开发参数]页面,在[正式环境]标签页下,配置正式环境的回调地址。

  1. 在下单时传入回调地址。 注意:若您传入的回调地址和商户平台配置的回调地址有冲突,以您传入的回调地址为准。

三、请求地址替换

正式环境的请求地址和测试环境不同,请注意切换。

1. 产线请求地址

服务请求地址
收款服务https://pay-gate.payermax.com/aggregate-pay-gate/api/gateway
付款服务https://pay-gate.payermax.com/aggregate-pay-gate/api/gateway/v2

2.切产线注意事项(收款服务):

Released under the MIT License.