Skip to content

接入指南

商富通将官网介绍与开发文档放在同一套站点里,适合对外展示平台能力,也方便技术团队直接按文档接入。

文档结构

  • 接入指南:说明网关接入前准备、签名与回调规则。
  • API 文档:按支付、退款、转账、分账、扫码 POS 拆分接口能力。
  • 合作与支持:说明平台适用场景、交付方式与服务支持。

推荐接入路径

在线支付接入

  1. 申请商户号、应用 ID、签名密钥,并确认测试环境与生产环境。
  2. 对接统一下单接口,拿到支付参数后在前端或业务系统发起收款。
  3. 实现支付通知、退款通知、转账通知的验签与幂等处理。
  4. 根据业务需要接入退款、转账、分账、余额查询等资金能力。

扫码POS接入

  1. 为设备申请 deviceId、厂商标识,并确认设备侧使用的 appIdappSecret 和接口地址。
  2. 当前源码未提供独立对外 /api/device/params 接口,设备参数通常由交付侧或商户后台预先下发;设备拿到 appIdappSecret 后再调用“设备初始化”获取 merchantId
  3. 再对接设备支付、订单查询、退款、交易记录、汇总查询等接口。
  4. 注意扫码 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 + 接口路径。
  • 如果其他资料与本站字段、状态或接口清单不一致,以本站和现网系统实现为准。

如需继续补充更新日志、渠道说明、开户申请或工单中心,可沿着当前目录继续扩展,无需调整站点结构。