# 波比代付 · 商户使用指南

## 登录与账号

使用平台分配的商户邮箱和密码登录商户网站。商户号、API 密钥与登录密码用途不同；API 密钥只用于签名，不用于网页登录。

## 当前联调收单模式

商户可查询余额、提交代付资料、查询订单及在后台核对记录。联调订单显示“待通道处理”，接口状态为 `processing`，不会冻结或扣除资金，也不会发起实际付款。受理成功不代表收款人到账。

请使用虚构银行卡资料进行联调。联调订单不会在日后开启实付后自动转为实际付款。

## 业务总览

展示本商户可用余额、冻结金额、订单数量和账户状态。联调余额为零仍可提交联调订单；正式业务按照实际余额与开通配置执行。

## 代付订单

进入“代付订单 → 创建代付”，填写唯一商户订单号、收款人姓名、银行卡号、银行名称及人民币金额。金额最多两位小数。

可以按完整商户订单号或平台订单号查询。相同订单号与相同内容重复提交返回同一订单；同号不同内容会被拒绝。

| 页面状态 | 含义 |
| --- | --- |
| 待通道处理 | 已收到联调订单，保留等待处理，不执行实际付款 |
| 待提交 / 处理中 | 正式业务已受理，尚未确定付款终态 |
| 结果待确认 | 处理结果需要继续核实，请勿换订单号重复付款 |
| 成功 | 平台已确认成功结果 |
| 失败 | 平台已确认失败结果 |

## 资金流水

正式业务可查看充值入账、订单冻结、成功扣款及失败解冻记录。充值以实际收款核验为准。联调收单不会生成真实资金变动。

## API 接入

在“API 接入”页面核对商户号、调用 IP 白名单和备案回调地址。API 密钥重置后只显示一次，请安全保存；旧密钥立即失效，重置前应与技术人员协调。

按 [波比代付 API 文档](API.md) 完成请求签名。当前商户的联调信息和测试步骤见 [接入资料](PARTNER_INTEGRATION.md)。

## 结果通知

正式业务产生成功或失败结果后，平台向备案地址发送签名通知。商户应验证签名及订单金额，幂等处理后返回 HTTP 2xx 和纯文本 `success`。失败通知会按计划重试，重复通知不能重复记账。

联调收单阶段没有真实付款终态，不会向业务回调地址发送虚构付款成功通知。

## 联系平台

调用 IP、费率或正式业务开通请联系平台管理员。结果回调地址可在“API 接入 → 修改结果回调地址”自行修改，输入当前登录密码确认。支持公网 HTTPS（443 端口），保存仅对新订单生效，历史订单继续使用原地址；保存不会发送测试通知。接口错误、时间格式、签名与金额规范以 API 文档为准。