# 开发者中心使用指南 ## 1. 接入须知 ### 1.1 账号申请 如果您已有权限登录PayerMax商户平台，可以直接使用该账号登录 [开发者平台](https://developer.payermax.com/base-setup/cashier-pay-method) ，也可以使用任意邮箱直接注册开发者中心后使用。 ### 1.2 测试联调 a. 请先确认您需要接入的是收单还是付款产品，收单可以根据您的产品匹配需要的[集成模式](https://docs.payermax.com/202606-version/acquiring/introduction.md)。 b. 通过开发者平台 **基础设置** → **开发信息** 获取测试商户号、AppID、PayerMax公钥信息，并上传商户公钥信息。 c. 接入的每个接口都要进行正反用例的测试，回调接口要保证响应正确的报文，保证接入的质量减少产线问题。 d. 测试环境mock支付，请参考 [收单交易测试](https://docs.payermax.com/202606-version/receipt/test-cases.md)以及 [付款交易测试](https://docs.payermax.com/202606-version/disbursement/test-cases.md)。 ### 1.3 上线 a. 联调完成后，请在开发者平台的 **验收** 菜单，自助验收： ![](https://img-cdn-sg.payermax.com/public/20260617-eaab3cb9-7119-44df-b39e-010d544879dc.png) b. 验收完成 - 开发者平台可以在 **产线配置** → **密钥配置** 页面获取产线商户号appid和平台公钥，配置产线商户公钥； - 管理员可以在商户平台 **设置服务** → **支付方式可用性** 菜单下查看产线可用支付方式，管理员也可给操作员分配查看权限。 c. 验收未完成 + 若对接问题，请修改并重新请求后，再次验收； + 若产线合约未生效，您也可以向我方商务了解进度。 ## 2. 基础设置 ### 2.1 开发参数配置 + **会员号、商户号、appId**：系统自动生成供开发者测试环境使用的一套参数； + **密钥类型**：RSA； + **公钥上传**：开发者需要上传商户公钥给payerMax，用于验证商户签名，防止报文在网络传输过程中被篡改； + **邀请协作者**：被邀请人和您共用同一个开发者平台商户号； ![](https://img-cdn-sg.payermax.com/public/20260617-dd6c44f2-2de5-40ce-a838-62c2eaa10f5b.png) ### 2.2 通知地址 开发者可以根据不同的交易类型，分别设置对应的通知地址，以供接入方服务端接收来自 PayerMax 服务端提供的订单异步回调结果。 ::: warning 注意： + 如后台未配置，可在下单参数的notifyUrl中传递 + 如后台和下单参数中都没有，则PayerMax不会回调 + 常用回调： + 收单业务：收单、退款（如果有api退款可配，产线订单也可商户平台手动发起）、争议（产线交易可商户平台查询） + 出款业务：出款 + 其他通知请先确认贵司集成模式，如未生效可工单咨询 ::: ![](https://img-cdn-sg.payermax.com/public/20250722-2907f1fc-6a3c-4eff-af76-af363837e751.png) ### 2.3 支付方式开启关闭 默认支付方式全部开启，您可关闭某些支付方式。 ![](https://img-cdn-sg.payermax.com/public/20250722-342fe9fd-a4aa-455a-8dc0-857d453c2539.png) ## 3. 开发者工具 ### 3.1 RSA密钥生成 点击Generate Key Pair，即可自动生成商户私钥和公钥。 ![](https://img-cdn-sg.payermax.com/public/20250722-4b64204d-c742-44f1-a884-ccc9ee32483c.png) ### 3.2 RSA签名 + **商户私钥**：即传上步生成的私钥即可。注意：商户公钥需要上传到 **基础设置** → **开发信息** → **公钥上传**； + **请求报文**：接口Body请求体（原始请求体，不要格式化）； + 点击“加签”即可生成加签数据； + **PayerMax公钥**：在 **基础设置** → **开发信息** → **公钥上传** 中，点击复制。 ![](https://img-cdn-sg.payermax.com/public/20250722-cd5b6608-3589-44ad-a5fd-fe2972c7a29b.png) ### 3.3 请求示例 商户号、appId默认取 **基础设置** → **开发信息** 中的配置，您选择接口名称和填入商户私钥，点发送请求按钮即可。 ![](https://img-cdn-sg.payermax.com/public/20250722-5d0128bf-0157-47f7-8f51-616b5861817a.png) ### 3.4 请求日志 可查询近三天的日志。 ![](https://img-cdn-sg.payermax.com/public/20250722-05945bfa-3648-4a3e-be3f-bbecb6eeb0b6.png) ### 3.5 工单入口 点击右下角咨询按钮，可以发起工单咨询。 ![](https://img-cdn-sg.payermax.com/public/20250722-4a0f337e-f974-4392-bc36-7053279eeefd.png) ## 4. 订单列表 测试环境订单列表，可以看到订单状态和自助mock回调。 ### 4.1 收款单查询 - **支付信息**：可以看到支付方式、支付状态等； - **补发回调**：可以手动补发回调； - **风控回调**：如果在**基础设置-开发信息-通知地址**里配置了对应回调地址，您可以mock回调。 ![](https://img-cdn-sg.payermax.com/public/20260617-fabf15dd-2424-443c-ba37-d0d02c0d4221.png) ### 4.2 付款单查询 - **指定回调**：支付中订单可以指定回调成功/失败，成功单可以指定回调退票； - **补发回调**：可以手动补发回调。 ## 5. 产线配置 邮箱有商户平台登录权限，才可以看到这个菜单；里面的变更操作需贵司商户平台的管理员审批。 ### 5.1 密钥配置 商户号首次配置公钥的步骤为： 1. 首次将商户公钥复制到"商户公钥"输入框后，点击保存； 2. 贵司商户平台的管理员审批； 3. 审批通过，刷新页面则可以看到商户公钥已配置。 ![](https://img-cdn-sg.payermax.com/public/20251204-999bf07d-1b72-4b1d-94ef-daf349a57a27.png) ### 5.2 密钥升级 旧公钥与新公钥共存。 1. 如后续更换密钥则点击“升级密钥”，粘贴新的商户公钥，点击保存； 2. 贵司商户平台的管理员审批； 3. 审批通过，刷新页面则可以看到商户公钥、商户升级公钥； 4. 线上没有旧的商户私钥请求后，可以申请下线旧的商户公钥，也需管理员审批。 ![](https://img-cdn-sg.payermax.com/public/20251204-9e48a433-64be-4d73-8dfc-d946138d007d.png) ### 5.3 变更记录 您可查询历史操作日志，比如可看到变更内容。 ![](https://img-cdn-sg.payermax.com/public/20251204-a6c4601f-5292-4601-a816-4ffbecb52b1c.png)