Appearance
接入指南
商富通将官网介绍与开发文档放在同一套站点里,适合对外展示平台能力,也方便技术团队直接按文档接入。
文档结构
接入指南:说明网关接入前准备、签名与回调规则。API 文档:按支付、退款、转账、分账、扫码 POS 拆分接口能力。合作与支持:说明平台适用场景、交付方式与服务支持。
推荐接入路径
在线支付接入
- 申请商户号、应用 ID、签名密钥,并确认测试环境与生产环境。
- 对接统一下单接口,拿到支付参数后在前端或业务系统发起收款。
- 实现支付通知、退款通知、转账通知的验签与幂等处理。
- 根据业务需要接入退款、转账、分账、余额查询等资金能力。
扫码POS接入
- 为设备申请
deviceId、厂商标识,并确认设备侧使用的appId、appSecret和接口地址。 - 当前源码未提供独立对外
/api/device/params接口,设备参数通常由交付侧或商户后台预先下发;设备拿到appId、appSecret后再调用“设备初始化”获取merchantId。 - 再对接设备支付、订单查询、退款、交易记录、汇总查询等接口。
- 注意扫码 POS 接口签名规则与普通支付网关不同,不能混用。
推荐先读
文档说明
当前站点已整理成“商富通”品牌下的本地文档结构,覆盖普通支付网关与扫码 POS 两条接入线。
普通支付网关当前对外域名为 https://pay.yefupay.cn,扫码 POS 当前按现网部署走商户域名 https://mch.yefupay.cn。实际投产时,以下内容应以你们最终分配的商户后台配置和渠道开通结果为准:
- 请求网关域名:
https://pay.yefupay.cn - 扫码 POS 域名:
https://mch.yefupay.cn - 商户号与应用 ID 长度规则
- 签名算法类型
- 渠道编码与支付方式清单
- 回调白名单与安全策略
当前对外口径
- 客户接入统一以本站文档为准。
- 所有普通支付网关接口完整地址 =
https://pay.yefupay.cn+ 接口路径。 - 扫码 POS 接口完整地址 =
https://mch.yefupay.cn+ 接口路径。 - 如果其他资料与本站字段、状态或接口清单不一致,以本站和现网系统实现为准。
如需继续补充更新日志、渠道说明、开户申请或工单中心,可沿着当前目录继续扩展,无需调整站点结构。