开发者中心使用指南
1. 接入须知
1.1 账号申请
登录开发者平台。如果您已经联系商务注册过 PayerMax后台,可以直接使用PayerMax账号登录;也可以使用任意邮箱直接注册开发者中心后使用。
1.2 测试联调
a. 请先确认您需要接入的是收单还是付款产品,收单可以根据您的产品匹配需要的集成模式。
b. 通过开发者平台
→ 获取测试商户号、AppID、PayerMax公钥信息,并上传商户公钥信息。c. 接入的每个接口都要进行正反用例的测试,回调接口要保证响应正确的报文,保证接入的质量减少产线问题。
d. 测试环境mock支付,请参考 收单交易测试以及 付款交易测试。
1.3 上线
a. 联调完成后,请在开发者平台的
菜单,自助验收:b. 验收完成
即可登录 PayerMax后台
→ 获取产线商户号、AppID、PayerMax公钥信息,并上传商户公钥信息;管理员可以在商户平台
→ 菜单下查看产线可用支付方式,管理员也可给操作员分配查看权限。
c. 验收未完成
若对接问题,请修改并重新请求后,再次验收;
若产线合约未生效,您也可以向我方商务了解进度。
2. 开发者中心
2.1 开发参数配置
商户号:系统自动生成供开发者测试环境使用;
APPID:商户应用Id,PayerMax分配给商户应用的唯一标识;
密钥类型:RSA;
公钥上传:开发者需要上传商户公钥给payerMax,用于验证商户签名,防止报文在网络传输过程中被篡改;
邀请协作者:被邀请人和您共用同一个开发者平台商户号;
绑定产线商户号:测试环境用开发者平台商户号联调验收后,可在商户平台配置获取对应产线商户号开发参数。
2.2 通知地址
开发者可以根据不同的交易类型,分别设置对应的通知地址,以供接入方服务端接收来自 PayerMax 服务端提供的订单异步回调结果。
注意:
- 如后台未配置,可在下单参数的notifyUrl中传递
- 如后台和下单参数中都没有,则PayerMax不会回调
- 常用回调:
- 收单业务:收单、退款(如果有api退款可配,产线订单也可商户平台手动发起)、争议(产线交易可商户平台查询)
- 出款业务:出款
- 其他通知请先确认贵司集成模式,如未生效可工单咨询
2.3 支付方式开启关闭
默认支付方式全部开启,您可关闭某些支付方式。
3. 开发者工具
3.1 RSA密钥生成
点击Generate Key Pair,即可自动生成商户私钥和公钥。
3.2 RSA签名
商户私钥:即传上步生成的私钥即可。注意:商户公钥需要上传到
→ → ;请求报文:接口Body请求体(原始请求体,不要格式化);
点击“加签”即可生成加签数据;
PayerMax公钥:在
→ → 中,点击复制。
3.3 请求示例
商户号、appId默认取
→ 中的配置,您选择接口名称和填入商户私钥,点发送请求按钮即可。3.4 请求日志
可查询近三天的日志。
3.5 订单列表
3.6 工单入口
点击右下角咨询按钮,可以发起工单咨询。