开发者中心使用指南

1. 接入须知

1.1 账号申请

如果您已有权限登录PayerMax商户平台，可以直接使用该账号登录 开发者平台 ，也可以使用任意邮箱直接注册开发者中心后使用。

1.2 测试联调

a. 请先确认您需要接入的是收单还是付款产品，收单可以根据您的产品匹配需要的集成模式。

b. 通过开发者平台 基础设置 → 开发信息 获取测试商户号、AppID、PayerMax公钥信息，并上传商户公钥信息。

c. 接入的每个接口都要进行正反用例的测试，回调接口要保证响应正确的报文，保证接入的质量减少产线问题。

d. 测试环境mock支付，请参考 收单交易测试以及 付款交易测试。

1.3 上线

a. 联调完成后，请在开发者平台的 验收 菜单，自助验收：

b. 验收完成

• 开发者平台可以在 产线配置 → 密钥配置 页面获取产线商户号appid和平台公钥，配置产线商户公钥；

• 管理员可以在商户平台 设置服务 → 支付方式可用性 菜单下查看产线可用支付方式，管理员也可给操作员分配查看权限。

c. 验收未完成

• 若对接问题，请修改并重新请求后，再次验收；

• 若产线合约未生效，您也可以向我方商务了解进度。

2. 基础设置

2.1 开发参数配置

• 会员号、商户号、appId：系统自动生成供开发者测试环境使用的一套参数；

• 密钥类型：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 工单入口

点击右下角咨询按钮，可以发起工单咨询。

4. 订单列表

测试环境订单列表，可以看到订单状态和自助mock回调。

4.1 收款单查询

• 支付信息：可以看到支付方式、支付状态等；

• 补发回调：可以手动补发回调；

• 风控回调：如果在基础设置-回调地址配置里配置了对应回调地址，您可以mock回调。

4.2 付款单查询

• 指定回调：支付中订单可以指定回调成功/失败，成功单可以指定回调退票；

• 补发回调：可以手动补发回调。

5. 产线配置

邮箱有商户平台登录权限，才可以看到这个菜单；里面的变更操作需贵司商户平台的管理员审批。

5.1 密钥配置

商户号首次配置公钥的步骤为：

1. 首次将商户公钥复制到"商户公钥"输入框后，点击保存；

2. 贵司商户平台的管理员审批；

3. 审批通过，刷新页面则可以看到商户公钥已配置。

5.2 密钥升级

旧公钥与新公钥共存。

1. 如后续更换密钥则点击“升级密钥”，粘贴新的商户公钥，点击保存；

2. 贵司商户平台的管理员审批；

3. 审批通过，刷新页面则可以看到商户公钥、商户升级公钥；

4. 线上没有旧的商户私钥请求后，可以申请下线旧的商户公钥，也需管理员审批。

5.3 审批记录

您可查询历史操作日志，比如可看到变更内容。