斗拱开发者论坛

线下账单支付 vue 组件库Repository：https://github.com/huifurepo/dg-bill-plugin简介解决重复造轮子的问题：提供一套专为手机端账单支付场景打造的UI 组件库，帮助开发者快速搭建账单页面，提升用户体验，无需担心适配，简化逻辑管理组件列表账单金额组件账单支付按钮组件账单 Banner 组件账单公告组件账单详情文本组件账单明细选择组件账单分割占位组件组件模拟器查看演示接入说明安装npm i @chinapnr/dg-bill-plugin 配置 easycom打开 /src/pages.json 进行配置 "easycom": { "autoscan": false, "custom": { "mx-(.*)": "@chinapnr/dg-bill-plugin/lib/$1/index.vue" } } 在 /src/App.vue 中添加组件样式@import '@chinapnr/dg-bill-plugin/lib/styles/matrix.scss'; 在 /src/pages 文件夹内的任意 vue 文件中，直接使用组件库标签<template> <mx-bill-notice>缴费公告</mx-bill-notice> </template>

DG Python SDKRepository：https://github.com/huifurepo/dg-python-sdkdougong sdk 工具类安装远程下载并安装：pip install dg-sdk简介为了提高客户接入的便捷性，本系统提供 SDK 方式介入，使用本 SDK 将极大的简化开发者的工作，开发者将无需考虑通信、签名、验签等，只需要关注业务参数的输入。使用方法初始化SDK未入网前，可使用以下测试商户参数进行开发测试import dg_sdk huifu_id = "6666000108854952" sys_id = "6666000108854952" product_id = "YYZY" private_key= "MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCxtfk3rjwdpBV81WBy5jIMcDLFdvHckhjGXkmWfaBn7euPRyetEhS4inpr7EvQ5KDUXNBPljI2NVhG/LEGZKvau1MW8j3t7dJ3gWafuVGsCiLJHU79sIRHf11nKOTykX5WxB/7MMwRnZsECuaZyCk7WPuSAlznqbDJdrZTzHhjQzMhjto1qD6+vc0OxyaBFlOY9piBtEfecsvD+6GfQ8exFqwzblJm9iZPYw02DaeUDLFO9Umn7i7gShlj/1Hh8nEM7YitpF/p26o+MC9LHWbIjgzjvNVhSRVmbvWys+3S11Zm/vux6Yzfk0H3fqrksAKSEkLEtEoYKS4wKjHdecztAgMBAAECggEACy1g4WmqCks5tsJM8K0d1L5x0w2qJK9js4ZWpop8Pk0ulbJqAm6ysvCyxnr0Qc0/eFvmFjtiKRqt1LksATTvwjAqB7Vww7hDlpSi+cTUKDfy/CdFwpsJlt2h6E0gKUmRYq+vO0NUcn8xMs3ktyNpxHvSRtqzMTbxEZrP2PFxWPzUKGNyk53FTlJ64YCoGQqWeGhA5LO6QLPHlAxIrvRf9B5dtXQr5XZXVqS9MwjtsRPvQPWiFXxlzvhJRcL/wXehcNextHzpMMgX/idB3HIpIl6XXLKiFUR4rBDJIMiQjQvS6zz2l1zpiJ0vWujVa3IY+PNefRA2ttg1DeC19GYa2QKBgQDh7AkJ7wut7p4qYAdcFEDVhFgP5mnSRyOBGWmClHYE4RIFplPiv4yO0fttAjFuCg4Zaxq49BuV3zshWOEIr72VK6wMa6Z+QbfXNr/1DT6nW+ktgXTw2G9Ts/nZiMrpcsbl7qvwChfJAPvEwnyP7Ckmd9t2WbQisuYZc+Vu8znO7wKBgQDJXskTiExEipQSOcVH5cX/ExVyj9MoLjmJhy3WTTDzGafgEoOPOfej2ZCgF6gCwugXJr+rtgdOpASk8WPACaCePdjdgQ2NVhSfV3op3TtvhgAPf3iI/zCVkZM4I1iZs6KjdHstLCKyAzCFBsowkPbfZBlFX4eO7Bk6XcIZ6x2h4wKBgQDcH64C5s4bb2beZOhm2Dj/kU54V4l93+CBFjCOkXaYdG+p35DWWspqEcCHSt68l8F7FLdZxEbodTPY3w+L9iejI4UkKPN1CzVD1U2dR4VnbY85zmwRiuCVzsM/KCCE61dOi4ktfbgFGhc1dEYHuROzLo8/tlFkiajW3eyLeSM3MwKBgATL3iw57d8gEeDRQXKx9WJa+QLOjDAD0dkFwEC/e+/+Z3I93qZVsiFT+E7n4VeXfuG2SZB0eH4WCApJuZ+EWzAJtxWnkkQQjdMxyTYgD99bKLs1xRA2S9j0K7aFmQGoNrJ//sMXrwfgbZJtk/lOKqMthjCR0u/DjeJHA22MnRsTAoGADXzJs/of0JExvQWwfdIUnSEPs/PgTrrJpo+CAdXnagYHF+InrmvIcNwx6ZzIs+9aGwUt0d/YsSpJkHMfAtTwZjB7sSw8Cg5DZ179Jy3YkKhFPvZv2ZCANa5J74HZNQUrUUL6O4FouZUiLwFlq8YuUPRtkAjYwyS/jwUbhJzqZhQ=" public_key = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAkMX8p3GyMw3gk6x72h20NOk3L9+Nn9mOVP6+YoBwCe7Zs4QmYrA/etFRZw2TQrSc51wgtCkJi1/x8Wl7maPL1uH2+77JFlPv7H/F4Lr2I2LXgnllg6PtwOSw/qvGYInVVB4kL85VQl0/8ObyxBUdJ43I0z/u8hJb2gwujSudOGizbeqQXAYrwcNy+e+cjodpPy9unpJjBfa4Wz2eVLLvUYYKZKdRn6pZR2cQsMBvL30K4cFlZqlJ9iP2hTG3gaiZJ9JrjTigwki0g9pbTDXiPACfuF1nOeObvLD22zBbgn1kwgfsqoG67z7g84u2jvfUFCzX1JRgd0xfNorTRkS2RQIDAQAB" dg_sdk.DGClient.mer_config = dg_sdk.MerConfig(private_key, public_key, sys_id, product_id, huifu_id) 参数说明：参数中文名public_key汇付公钥private_key商户私钥sys_id系统号product_id产品号huifu_id商户号接口调用以支付宝支付为例，根据接口文档说明，构建请求参数体required_params = { "trade_type": "A_NATIVE", "trans_amt": "1.00", "goods_desc": "goods_desc", } 调用接口url = "https://api.huifu.com/v2/trade/payment/jspay" result = dg_sdk.request_post(url, required_params) 其他调用方式除了通用的调用接口之外，SDK 还针对部分重要交易接口提供了一种更便捷的方法，将一些默认、非必须、无需特别关注的参数传递，以及数据脱敏、加密处理进行了封装。SDK 会自动生成必传参数：req_date 以及 req_seq_id，如不想使用SDK内部生成的值，直接传入即可。针对 huifu_id 以及 product_id，如不传，SDK会使用初始化时传入的值。使用方法如下所示：response = dg_sdk.ScanPayment.create(trade_type=trade_type, trans_amt=amount, goods_desc="goods_desc", **extra_info) print(response) 现支持模块功能列表如下聚合扫码 ScanPayment聚合正扫 - create订单查询 - query退款创建 - refund退款查询 - refund_query反扫 - micro_create关单 - close关单查询 - close_query支付托管预下单 - preorder_create线上交易 OnlinePayment线上交易查询 - query线上交易退款 - refund线上退款查询 - refund_query银联APP支付 - union_app_create网银支付页面版 - web_page手机网页支付 - wap_page网银付款银行账户查询 - payer_query网银支付银行列表查询 - bank_list快捷代扣对象 QuickAndHoldPay支付申请 - apply快捷支付确认 - confirm快捷/代扣绑卡申请 - bind_card快捷/代扣绑卡确认 - bind_card_confirm快捷代扣解绑 - un_bind快捷代扣短信重发(v1) - sms_code快捷页面版 - page代扣 - with_hold_pay线上交易查询 - query退款 - refund退款查询 - refund_query快捷支付用户注册 - customer_reg余额支付 AcctPayment余额支付 - create余额支付交易查询 - query余额支付退款 - refund余额支付退款查询 - refund_query余额查询 - balance_query代发 Surrogate代发 - create出金交易查询 - query取现对象 Settlement取现 - create取现查询 - query延时交易对象 Delaytrans延时交易确认 - confirm延时交易确认查询 - confirm_query延时交易退款 - confirm_refund交易确认批量信息查询(v1) - query_confirm_list查询交易分账明细 - split_list银行卡分期 Installment银行卡分期支付签约 - sign二段式分期支付申请 - payment_apply二段式分期支付确认 - payment_confirm银行卡分期退款 - refund银行卡分期查询 - query商户对象 Merchant企业类型商户进件 - create_enterprise个体户类型商户进件 - create_individual商户基本信息修改 - modify商户详细信息查询 - query_merch_info新增总部 - add_headquarters修改总部 - modify_headquarters总部商户绑定&解除 - bind_headquarters查询账户信息 - query_acct_info商户业务开通 - reg_busi_info商户业务开通修改 - modify_busi_info申请单状态查询 - query_apply_status商户图片资料上传(v1) - upload商户分账配置 - add_split_config商户分账配置查询 - query_split_config商户分期配置 - installment_config商户分期配置详情查询 - query_fenqi_config活动报名，支持微信 - reg_activity机构下属商户查询 - branch_mercust_query商户关系绑定 - branch_config机构列表查询 - branch_query分账用户对象 Member企业用户基本信息注册 - create_enterprise个人用户基本信息注册 - create_individual查询账户信息 - query_acct_info企业用户基本信息修改 - modify_enter_base_info个人用户基本信息修改 - modify_individual_base_info用户业务入驻 - reg_busi_info用户详情查询 - query_user_detail微信商户 WxMerchant微信商户配置 - config微信商户配置查询 - query_config微信实名认证 - realname微信实名认证状态查询 - query_realname_state证书登记 - add_cert_info微信特约商户进件申请 - apply_register_mer查询微信申请状态 - query_apply_reg修改微信结算帐号 - modify_settlement_info查询微信结算账户 - query_settlement_info微信关注配置 - subscribe_config微信关注配置查询 - query_subscribe_config支付宝商户 AliMerchant证书登记 - add_cert_info签约版-换取应用授权令牌 - exchange_app_auth_token签约版-申请当面付代签约 - apply_face2face_sign签约版-查询申请状态 - query_apply_order_status直付通-商户进件申请 - zft_apply_register_mer直付通-分账关系绑定&解绑 - zft_split_config直付通-分账关系查询 - query_zft_split_config云闪付商户 UniPayMerchant云闪付活动商户入驻 - apply_register_mer云闪付活动商户入驻状态查询 - query_apply_reg云闪付活动商户详细信息查询 - query_mer_base_info云闪付活动列表查询 - query_activity_list云闪付活动报名 - enlist_activity云闪付活动报名进度查询 - query_enlish_activity_status花呗分期配置对象 Huabei支付宝间连证书上传 - add_ali_cert_info创建花呗分期商家贴息方案 - create_pcredit_solution上架/下架花呗分期贴息 - modify_solution_status更新花呗分期商家贴息方案 - modify_pcredit_solution查询花呗分期贴息 - query_hb_solution花呗活动详情查询 - query_hb_activity终端设备 Terminal新增终端设备 - add注销终端设备 - cancel绑定终端查询 - query_list智能终端mis接入 Cloudmis智能终端接入 - device_infoPOS 机交易 POS银行卡交易查询 - query工具类 DGTools校验签名 - verify_sign校验 webhook 返回报文签名 - verify_webhook_sign使用公钥加密敏感信息 - encrypt_with_public_key详情参考SDK 接入说明

汇付支付斗拱商户 Vue 组件库Repository：https://github.com/huifurepo/dg-dashboard-sdk本地开发指南tips:本项目仅适用于使用Vue2版本和element-ui2.15.71.1安装npm i 1.2将当前项目生成软链npm link 1.3.在使用当前项目的demo中，执行如下命令，指向当前项目// 名称参考rollup.config.js中的output导出的name npm link dg-element 2.额外配置(保证demo与本项目用一套elementUI和vue，防止样式污染)当前项目中执行如下命令: rm -rf node_modules/vue rm -rf node_modules/element-ui // 若使用组件库的项目与组件库项目为同一层级目录 ln -s node_modules/vue ../demo/node_modules/vue ln -s node_modules/element-ui ../demo/node_modules/element-ui 4.重启demo和组件库5.发布流程nrm use npm //需要修改npmBuild中config.json文件 npm run release 使用已经发布的仓库假设发布的仓库名称为dg-element安装npm 安装npm i dg-element -S 引入完整引入在 main.js 中写入以下内容：import Vue from 'vue'; import DGElement from 'dg-element'; // 引入style样式 import 'dg-element/dist/dg-element.css'; import App from './App.vue'; import store from './store'; // 全局注册SDK Vue.use(DGElement); new Vue({ el: '#app', render: h => h(App) }); 在页面中写入可引入相关组件：<template> <div> {/* 商户列表组件 */} <HMerchantList></HMerchantList> </div> </template> <script> export default { name: 'MerchantList', };

汇付支付斗拱 JAVA 语言 SDKRepository：https://github.com/huifurepo/bspay-java-sdk-parent欢迎使用 斗拱SDK for Java 。斗拱SDK for Java让您不用复杂编程即可访斗拱开放平台开放的各项能力，SDK可以自动帮您满足能力调用过程中所需的证书校验、加签、验签、发送HTTP请求等非功能性要求。 同时，斗拱dg-lightning-sdk提供聚合支付快速接入能力，能大大提升商户接入效率，可以参考dougong-java-lightning-sdk项目，主要包括交易创建、交易查询、交易关闭、交易退款、交易关闭查询、交易退款查询。环境要求斗拱SDK for Java 需要使用JKD 1.8或其以上版本。SDK接入准备提交商户材料完成进件及相关业务配置；登录控台获取/配置密钥，参见《商户密钥操作说明》；准备工作完成后，注意保存如下信息，后续将作为使用SDK的输入。商户的私钥、商户的公钥、汇付的公钥；安装依赖推荐通过Maven来管理项目依赖，您只需在项目的pom.xml文件中声明如下依赖 <dependency> <groupId>com.huifu.bspay.sdk</groupId> <artifactId>dg-java-sdk</artifactId> <version>3.0.2</version> </dependency> <dependency> <groupId>com.huifu.dg.lightning.sdk</groupId> <artifactId>dg-lightning-sdk</artifactId> <version>1.0.3</version> </dependency> <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>1.2.70</version> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpclient</artifactId> <version>4.5.2</version> </dependency> <dependency> <groupId>org.apache.httpcomponents</groupId> <artifactId>httpmime</artifactId> <version>4.5.2</version> </dependency> <!-- util --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-lang3</artifactId> <version>3.6</version> </dependency> <!-- okhttp --> <dependency> <groupId>com.squareup.okhttp3</groupId> <artifactId>okhttp</artifactId> <version>4.9.1</version> </dependency> 快速使用安装好依赖库保证运行环境没问题，可直接运行SDK demo，如调用商户详细信息查询正常返回说明运行环境配置成功；改商户配置信息(商户号、私钥)，看下单是否成功，如能成功，说明商户配置成功，否则请检查商户控台配置；部署服务端服务：安装并部署服务端服务到您的服务器，前端应用调用SDK；前端应用对接：前端应用通过网络请求获取到应用服务端从SDK获取的支付信息。在前端页面或者APP内处理后，发起支付。以下这段代码示例向您展示了使用斗拱SDK for Java调用一个API的3个主要步骤：初始化商户参数，完成Client实例并初始化。系统初始化时只需做一次；创建API请求对象并设置Model参数。必填参数用set方法，非必填参数用addExtendInfo()方法设置；发起请求并处理响应或异常。 public static void main(String[] args) throws Exception { // 1. 设置商户参数（全局只需设置一次） doInit(OppsMerchantConfigDemo.getMerchantConfig()); // 2. 组装交易参数 TradePaymentMicropayRequest request = new TradePaymentMicropayRequest(); //请求日期 request.setReqDate(DateTools.getCurrentDateYYYYMMDD()); //请求流水号（保证唯一） request.setReqSeqId(SequenceTools.getReqSeqId32()); //交易金额（单位元） request.setTransAmt("0.01"); //条形码 request.setAuthCode("287606928207260511"); //商品描述 request.setGoodsDesc("测试商品"); //商户id request.setHuifuId("6666000103124174"); // 3.拓展参数 (可选) // 该笔交易的异步通知地址（http/https异步通知地址，必须以virgo://开头） request.addExtendInfo("notify_url", "virgo://http://www.baidu.com"); try { // 3. 发起API调用 Map<String, Object> response = doExecute(request); System.out.println("返回数据:" + JSONObject.toJSONString(response)); } catch (Exception e) { e.printStackTrace(); } } 异步消息说明接口如果有异步返回，请参考斗拱API文档异步消息说明文档SDK文档首页

Dougong Lightning SDK（Java）项目说明Repository：https://github.com/huifurepo/dg-lightning-sdk-java概述Dougong Lightning SDK 以 V4 插件的形式提供极简聚合支付能力，遵循“化繁为简、必参极简 + 可选灵活扩展”的设计风格，通过统一的调用入口与对象化入参模型降低集成成本。主要特性统一入口：通过 Factory 创建客户端，所有能力从一个入口发起。必参极简：主交易字段最小化，低频参数走扩展注入。可插拔扩展：optional(key, value) 注入场景参数，保持模型稳定。统一管道：入参归一、扩展合并、序列化、路由与调用一体化。多场景覆盖：下单、查询、关单、退款、退款查询。包结构简述factory：统一入口与客户端创建（Factory）。biz.client：业务客户端与链式扩展（CommonPayClient、BasePayClient）。biz.net：网关请求、签名与路由（BasePayRequest）。models：对象化入参/响应与领域对象（如 TradePaymentCreateRequest、分账对象）。utils：基础工具与配置（BasePay、DateTools、SequenceTools 等）。安装与引入在上层业务模块的 pom.xml 中引入：<dependency> <groupId>com.huifu.dg.lightning.sdk</groupId> <artifactId>dg-lightning-sdk</artifactId> <version>1.0.3</version> </dependency> 场景快速冒烟目标：零门槛验证“统一入口 + 极简扩展”是否接通。示例目录：查看 dougong-java-sdk项目的bspay-java-sdk-sample 项目操作步骤：在示例目录选择一个交易类型示例类（如 JSAPI/正扫/付款码）。设置主交易字段：req_date、req_seq_id、huifu_id、goods_desc、trans_amt、trade_type。注入通道扩展：将场景参数对象序列化为 JSON，使用 optional("method_expand", json) 注入；叠加收单能力：如需贴息/增值等，序列化为 JSON，使用 optional("tx_metadata", json) 注入。运行示例类的 main 或测试方法，观察返回的交易号/二维码/支付参数等核心结果。快速开始// 1. 初始化商户配置（建议从配置中心加载 MerConfig 后调用 BasePay.initWithMerConfig） BasePay.initWithMerConfig(merConfig); // 2. 组装必填入参（以聚合下单为例） TradePaymentCreateRequest req = new TradePaymentCreateRequest(); req.setReqDate(DateTools.getCurrentDateYYYYMMDD()); req.setReqSeqId(SequenceTools.getReqSeqId32()); req.setHuifuId("6666xxxxxxxxxxx"); req.setGoodsDesc("商品描述"); req.setTransAmt("0.01"); req.setTradeType("A_JSAPI"); // 3. 通过工厂获取客户端并发起调用 Map<String, Object> resp = Factory.Payment.Common() .optional("notify_url", "https://your.notify/url") .create(req); 可选参数扩展使用链式的 optional(key, value) 在客户端注入低频参数，这些参数将与请求体合并并覆盖同名字段。下单统一入口与扩展模型单一入口：所有支付下单统一通过 CommonPayClient#create 发起交易抽象：用 trade_type 标识具体支付场景；用 method_expand 承载该场景的专有参数，二者组合即为“交易对象”的扩展模型。收敛策略：新增或变更任意交易场景时，仅需定义场景参数对象 → 序列化为 JSON → 注入 method_expand，无需新增接口或客户端方法。推荐用法：保持必参极简，扩展参数一律通过 optional("method_expand", json) 注入；若无扩展，传 "{}" 即可。调用示例：req.setTradeType("T_JSAPI"); String json = JSON.toJSONString(wxData); Map<String, Object> resp = Factory.Payment.Common() .optional("method_expand", json) .create(req); 交易设计理念意向订单（主交易字段）：用统一的主字段表达订单意向与基础要素，如日期、流水号、商户、金额、商品等，保持稳定不随渠道变化。通道信息（trade_type + method_expand）：以 trade_type 选择支付通道/场景，以 method_expand 承载该通道的专有参数，二者组合定义“如何支付”。新增渠道能力只需新增专有参数对象并通过 method_expand 注入，无需改动统一入口。收单附加能力（tx_metadata）：用于承载收单侧扩展能力，如贴息、分期、优惠分账、增值等，以 JSON 字符串注入即可。三层划分：将一次交易抽象为“意向订单（主字段）+ 通道（trade_type+method_expand）+ 收单附加能力（tx_metadata）”。该划分确保主交易模型稳定、通道能力可插拔、收单扩展可累加，统一入口下自然演进。统一请求管道（简述）入参归一：将请求对象规范化为键值对。扩展合并：合并扩展参数，客户端注入覆盖同名字段。特殊序列化：对象型特殊字段统一序列化为 JSON 字符串。路径解析与调用：将功能码解析为网关路径，完成 HTTP 调用并返回统一结果。常用接口示例支付下单：CommonPayClient#create（TradePaymentCreateRequest）支付查询：CommonPayClient#query关单：CommonPayClient#close退款：CommonPayClient#refund退款查询：CommonPayClient#refundQuery开箱即用与场景示例项目定位：本包为 V4 极简插件，示例与运行入口位于主 SDK 项目。示例目录：bspay-java-sdk-parent/bspay-java-sdk-sample/src/main/java/com/huifu/bspay/sdk/demo/v4使用方式：在主 SDK 示例目录中选择对应交易类型的示例类，按需修改基础入参与扩展参数（trade_type + method_expand / tx_metadata），直接运行。配置说明：主 SDK 通过配置中心加载环境与密钥信息；如运行异常，请在主 SDK 项目中调整环境与商户配置。配置说明通过 BasePay.initWithMerConfig(MerConfig) 或 BasePay.initWithMerConfigs(Map<String, MerConfig>) 完成多商户配置加载（dg-lightning-sdk/src/main/java/com/huifu/dg/lightning/utils/BasePay.java:57-71）。调用时使用默认商户配置，或在请求方法中指定 merchantKey 选择商户配置（BasePayRequest 的对应重载）。BasePay.prodMode 控制目标环境域名（生产/联测/内部），统一封装于 BasePayRequest 调用路径解析。异常与错误许可与版本版本：1.0.3许可证：Apache-2.0（详见根 POM）

汇付支付斗拱 PHP 语言 SDK简介Repository：https://github.com/huifurepo/bspay-php-sdk为了提高客户接入的便捷性，本系统提供 SDK 方式介入，使用本 SDK 将极大的简化开发者的工作，开发者将无需考虑通信、签名、验签等，只需要关注业务参数的输入。下载地址SDK下载版本记录版本日期版本说明v1.0.02021/05/06初始版本v1.0.12021/08/23实现通用接口请求客户端演示demo，实现部分支付功能的封装v1.1.02021/10/12对接新版斗拱 API 接口v1.1.12021/11/02封装余额支付、取现、代发模块对象v1.1.22021/12/081. 封装快捷代扣、延时交易、商户管理模块；2. 优化 huifuid 方法参数，默认从配置文件中读取v1.1.32021/12/131. 优化 huifuid 方法参数2. 调整Demo 中 config.json 公私字段的命名3. 优化接口通讯安全处理v1.1.42021/12/211. 修复扫码接口地址问题2. 修复扫码支付模块支付类型对象数据格式化问题v1.1.52022/01/191. 封装微信、支付宝、云闪付商户管理模块对象；2. 封装分账用户管理模块对象v1.1.62022/04/211. 封装支付宝花呗分期模块对象；2. 封装终端报备模块对象；3. 封装银行卡分期模块对象；4. 封装交易取现、出金交易查询模块对象；5. 封装智能终端模块对象；6. 封装交易确认模块对象；7. 升级商户管理、快捷代扣、线上交易的部分接口为V2版本；v1.1.72022/05/051. 实现机构列表查询功能封装；2. 实现商户关系绑定功能封装；3. 实现机构下属商户查询功能封装；4. 升级商户图片上传接口为V2版本；v1.1.82022/05/121. 实现支付托管H5、PC、支付宝小程序、微信小程序预下单功能封装；2. 补充验签工具使用说明；v1.1.92022/07/141. 网银支付页面版、手机网页支付、快捷支付页面版接口只加签不验签；2. 商户图片上传接口免加解签；3. 优化预下单功能封装；v2.0.02022/09/161. 类名按资源路径生成；2. demo中字段说明更详细；版本要求PHP 版本 5.6 及以上SDK 包结构说明BsPaySdk 目录下内容为待添加到项目中的文件；BsPayDemo 目录下为示例项目，供接入时参考使用；使用方法1. 将 BsPaySdk 目录下文件内容整体复制到您的项目工程内2. 在您的项目创建 SDK 初始化的入口文件，完成如下配置：2.1 进行相关环境及调试参数的配置 # 设置是否调试模式，不配置默认关闭：false define("DEBUG", true); # 设置调试日志路径，不配置默认为SDK同级的log目录下 define("LOG", dirname(__FILE__)."/log"); # 设置生产模式，不配置默认生产模式：true，设置为 false 时调用联调测试环境 define("PROD_MODE", true); 2.2 完成 sdk 初始化 # 加载 SDK 初始化文件 require_once dirname(__FILE__). "/../BsPaySdk/init.php"; 2.3 完成系统参数的导入 # 从文件导入商户系统参数 BsPay::init(dirname(__FILE__). '/config/config_merch_default.json', false); # sdk也支持追加多套系统参数，并可以在调用接口时进行切换，适用于下辖多商户的系统接入 BsPay::init(dirname(__FILE__). '/config/config_merch_2.json', false, "merchantKey2"); BsPay::init(dirname(__FILE__). '/config/config_merch_3.json', false, "merchantKey3"); ... 2.4 以上内容，建议参考 SDK Demo 中 loader.php 文件内的代码写法3. SDK 调用方法（一）：使用接口 request 实例调用，以商户业务开通接口为例3.1 导入前一步实现的 SDK 初始化文件# 导入初始化内容 require_once dirname(__FILE__) . "/loader.php"; require_once dirname(__FILE__). "/../BsPaySdk/request/V2MerchantBusiOpenRequest.php"; 3.2 根据接口文档说明，创建对应请求的参数数据体 # 请求必填参数 $request = new V2MerchantBusiOpenRequest(); // 请求流水号 $request->setReqSeqId(date("YmdHis").mt_rand()); // 请求日期 $request->setReqDate(date("Ymd")); // 汇付ID $request->setHuifuId("6666000104778898"); // 渠道商汇付ID $request->setUpperHuifuId("6666000003080000"); # 请求拓展参数 (可选) $extendInfoMap = getExtendInfos() ; $request->setExtendInfo($extendInfoMap); 3.3 调用接口# 创建请求Client对象，调用接口 $client = new BsPayClient(); $result = $client->postRequest($request); 3.4 处理返回结果# 成功/失败应答的处理 if (!$result || $result->isError()){ //失败处理 var_dump($result -> getErrorInfo()); } else { //成功处理 var_dump($result); } 3.5 以上内容，建议参考 SDK Demo 中 V2MerchantBusiOpenRequestDemo.php 文件内的代码写法4. SDK 调用方法（二）：使用集中传参方式调用，以商户业务开通接口为例除基于接口 request 实例调用外，另提供一种集中传参方式，拓展适应不同需求；4.1 导入前一步实现的 SDK 初始化文件# 导入初始化内容 require_once dirname(__FILE__) . "/loader.php"; require_once dirname(__FILE__). "/../BsPaySdk/request/V2MerchantBusiOpenRequest.php"; 4.2 根据接口文档说明，创建对应请求的参数数据体 # 请求实例 $request = new V2MerchantBusiOpenRequest(); // 请求参数，不区分必填和可选，按照 api 文档 data 参数结构依次传入 $param = array( "funcCode" => $request->getFunctionCode(), "params" => array( "req_seq_id" => date("YmdHis").mt_rand(), "req_date" => date("Ymd"), "huifu_id" => "6666000104778898", "upper_huifu_id" => "6666000003080000", "balance_pay_config" => json_encode(array( "fee_rate" =>"2", "fee_fix_amt" =>"1", ),JSON_UNESCAPED_UNICODE|JSON_UNESCAPED_SLASHES), ), ); 4.3 调用接口# 创建请求Client对象，调用接口 $client = new BsPayClient(); $result = $client->postRequest($param); 4.4 处理返回结果# 成功/失败应答的处理 if (!$result || $result->isError()){ //失败处理 var_dump($result -> getErrorInfo()); } else { //成功处理 var_dump($result); } 5 验签工具（BsPayTools.php）校验签名 - verifySign_sort（此方法为返回报文签名验签，将返回data 按字母顺序排序后组成json 字符串，依据 RSA2 算法使用公钥进行验签示例：$data = array( 'bank_code' =>'10000', 'bank_message' =>'Success', 'hf_seq_id' =>'002900TOP2B220511142822P984ac132ff400000', 'huifu_id' =>'6666000108854952', 'qr_code' =>'https://qr.alipay.com/bax04465kcijedllqhuq004b', 'req_date' =>'20220511', 'req_seq_id' =>'202205111428211506200', 'resp_code' =>'00000100', 'resp_desc' =>'下单成功', 'trade_type' =>'A_NATIVE', 'trans_amt' =>'1.00', 'trans_stat' =>'P', ); $sign = "OUotiU75VW7SdEwLIZX3gAqSgZk8hCjE7r01WQr8mDdm23B+zd58r8HNWvE9BWV+mTwZ2iAOSuht9SOGM+spSYFANa3VIqMZzGim3y4aZmptQTTptNcclocsWyocn78efdAuTcGvf5dhUc6/Ue1oYV+BVhphYPmkKUKfxpEvBEvw/vlpsCu0I0Dx/k7kN6IaxY6mODypFmDtnEaZbkGaxbh8yxH1lJDn5/91YfD6vpK+sRJXiVXLzDK13BPAjQ3RAlFUxHJ8LPJbWQQpABQ94Gd1TTc/bfOluqUwJJbofC7WZiIOW6MKsa9gL5Y6lmbqFcMBKfvexJ0SlRFLWvSkQg=="; $merConfig = BsPay::getConfig(); $result = BsPayTools::verifySign_sort($sign,$data,$merConfig->rsa_huifu_public_key); 校验 webhook 返回报文签名 - verify_webhook_sign（此方法为异步回调验签方法，将返回 data 字符串与商户配置的key 组合后进行md5计算，返回的md5值与回调sign的比较结果示例：$data = array( 'bank_code' =>'10000', 'bank_message' =>'Success', 'hf_seq_id' =>'002900TOP2B220511142822P984ac132ff400000', 'huifu_id' =>'6666000108854952', 'qr_code' =>'https://qr.alipay.com/bax04465kcijedllqhuq004b', 'req_date' =>'20220511', 'req_seq_id' =>'202205111428211506200', 'resp_code' =>'00000100', 'resp_desc' =>'下单成功', 'trade_type' =>'A_NATIVE', 'trans_amt' =>'1.00', 'trans_stat' =>'P', ); $sign = 'dcc64089c44ea77cfde785de4cfa97ba'; $key = 'test_key'; $result = BsPayTools::verify_webhook_sign($sign,$data,$key);

汇付支付 Skill 产品包Repository: https://github.com/huifurepo/dg-payment-skills这是一个面向第三方客户的 Huifu 接入 Skill 包，用来帮助开发者借助 AI 工具完成汇付支付 / 斗拱 SDK 接入开发。README 按 产品线 -> 开发任务 -> 技术栈 导航，先帮你定位入口，再进入对应文档。当前仓库已收敛为单 Skill：正式 Skill：huifu-pay-integration服务端技术栈：Java、PHP；C#、Python、Go 保留入口说明前端支付组件：Node.js / Browser产品能力主线：聚合支付、托管支付、前端支付组件选择建议：优先使用聚合支付，接入更快、更轻量；当你需要托管收银台、项目制预下单或前端 checkout 能力时，再进入托管支付和前端支付组件路径。如何开始下文中的 references/... 均指 huifu-pay-integration/references/...。1. 先按产品线定位产品线适合什么场景从这里开始汇付支付集成（总入口）第一次接入汇付，需要先判断产品线、开发任务和阅读顺序huifu-pay-integration/SKILL.md聚合支付标准支付场景，想尽快完成服务端接入references/aggregation-quickstart.md托管支付（服务端）需要项目制预下单、托管收银台、查询 / 退款闭环references/hostingpay-quickstart.md前端支付组件需要在商户自有页面嵌入 checkout 或单支付按钮references/checkout-js.md2. 再按开发任务进入开发任务聚合支付托管支付 / 前端支付组件初始化 / 公共配置references/aggregation-base.mdreferences/hostingpay-base.md下单 / 预下单references/aggregation-order.mdreferences/hostingpay-preorder.md查询 / 关单 / 对账references/aggregation-query.mdreferences/hostingpay-query.md退款references/aggregation-refund.mdreferences/hostingpay-refund.md收银台组件接入 / 单支付按钮不适用references/checkout-js.md3. 最后按技术栈落地技术栈推荐入口说明Javareferences/shared-server-sdk-matrix.md聚合支付和托管支付都有稳定基线PHPreferences/shared-server-sdk-matrix.md聚合支付核心主链路和托管支付核心场景已覆盖C# / Python / Goreferences/shared-server-sdk-matrix.md当前只保留入口说明Node.js / Browserreferences/shared-frontend-sdk-matrix.md前端 JS SDK 能力矩阵Node.js / Browserreferences/checkout-js.md嵌入 checkout / 单支付按钮的实际入口产品线说明聚合支付聚合支付是一条服务端主线，适合标准支付接入和快速上线。推荐阅读顺序：references/aggregation-quickstart.md -> references/aggregation-base.md -> references/aggregation-order.md -> references/aggregation-query.md -> references/aggregation-refund.md（按需） 托管支付托管支付的服务端主线负责 SDK 初始化、预下单、查询、关单、对账和退款。推荐阅读顺序：references/hostingpay-quickstart.md -> references/hostingpay-base.md -> references/hostingpay-preorder.md -> references/hostingpay-query.md -> references/hostingpay-refund.md（按需） 前端支付组件前端支付组件用于在商户自定义页面中嵌入 checkout 组件或单支付按钮，让商户自己控制页面布局、品牌样式和交互流程。必须注意：前端 callback 不等于最终支付成功，最终订单状态仍应由服务端查询或异步通知确认。推荐主链路：服务端预下单：references/hostingpay-preorder.md -> 前端渲染 checkout / 按钮：references/checkout-js.md -> 服务端最终确认：references/hostingpay-query.md + references/hostingpay-async-webhook.md 共享资料层这些共享资料不再分散在多个 Skill 中重复维护：资料作用references/shared-signing-v2.mdV2 签名规则references/shared-async-notify.md接口 notify_url 异步通知规则references/shared-webhook-signing.md控台 Webhook 终端密钥与 MD5 验签规则references/shared-request-header-policy.md请求头与 skill 来源字段规则references/shared-server-sdk-matrix.md服务端多语言矩阵references/shared-frontend-sdk-matrix.md前端 JS SDK 矩阵references/shared-versioning-policy.md版本治理规则references/shared-release-checklist.md发布检查清单Skill 内部结构huifu-pay-integration/ ├── SKILL.md ├── agents/ │ └── openai.yaml └── references/ ├── shared-*.md ├── aggregation-*.md ├── hostingpay-*.md └── checkout-js-*.md 当前版本事实项目当前口径Skill 包版本1.2.0托管支付 Java SDK 常量版本dg-java-sdk 3.0.36聚合支付 Java SDK 版本dg-lightning-sdk 1.0.5PHP SDK 包huifurepo/dg-php-sdk 2.0.26前端收银台 JS SDK@dg-elements/js-sdk，接入时以项目锁定版本为准文档说明优先阅读 huifu-pay-integration/SKILL.md 与 references/ 下的场景文档服务端接入优先从 references/shared-server-sdk-matrix.md 和对应 *-base.md 开始前端接入优先从 references/shared-frontend-sdk-matrix.md 和 references/checkout-js.md 开始AI 生成接入代码时，不应自行猜测商户参数、项目配置或最终支付状态HUIFU_RSA_PRIVATE_KEY、HUIFU_RSA_PUBLIC_KEY 等敏感配置只能留在服务端官方技术支持如需官方技术支持或接入答疑，可通过以下官方渠道联系：客服电话：400-820-2819官方邮箱：cs@huifu.com企业微信技术支持群（仅用于接入答疑 / 技术支持）：

汇付支付斗拱 Go 语言 SDK 简介Repository：https://github.com/huifurepo/bspay-go-sdk为了提高客户接入的便捷性，本系统提供 SDK 方式接入，使用本 SDK 将极大的简化开发者的工作，开发者将无需考虑通信、签名、验签等，只需要关注业务参数的输入。 SDK 项目结构说明BsPaySdk -- SDK核心包, 包含通信, 加解签, 接口参数对象等config -- 商户配置ut -- 接口调用/参数赋值演示demoSDK 接入说明以下两种方式任选其一直接在go.mod中引用(require github.com/huifurepo/bspay-go-sdk/BsPaySdk [version])直接下载源码文件, 将BsPaySdk(SDK核心包)源码放入项目中SDK 使用说明接口命名直接根据接口URL来命名, 方便用户使用, 需要使用某接口时, 可直接使用接口中文名, 或接口URL(驼峰格式)进行搜索, 找到对应的struct, demo等 配置初始化初始化为全局配置(多商户模式下, 可初始化多份)第一个参数true:生产环境, false:测试环境第二个参数商户公私钥等信息配置dgSDK, _ := BsPaySdk.NewBsPay(false, "./config/config.json") 组装请求参数为了接口使用更加方便, 我们将参数粗分为必填/非必填, 必填直接放在结构体内, 非必填放在结构体的map字段ExtendInfos中 dgReq := BsPaySdk.V2MerchantBasicdataQueryRequest{ // 请求流水号 ReqSeqId: tool.GetReqSeqId(), // 请求日期 ReqDate: tool.GetCurrentDate(), // 汇付客户Id HuifuId: "6666000108854952", } // 设置非必填字段 dgReq.ExtendInfos = getExtendInfos() 发起API调用resp, err := dgSDK.V2MerchantBasicdataQueryRequest(dgReq)

一、常见问题Q1、什么场景下需要绑定appid、授权目录？A：微信支付交易发起依赖于公众号、小程序等应用与商户号的绑定关系，因此商户在完成签约后，需要确认当前商户号同appid的绑定关系，方可使用。 如果交易类型是T_JSAPI，则必须要配置授权目录；如果交易类型是T_MINIAPP，则必须要配置小程序appid。否则无法发起支付。Q2、支持绑定的APPID有哪些？A: 已通过微信认证的服务号、政府或媒体类公众号(原订阅号)、小程序、企业微信、移动应用。 注意只有政府或媒体类的订阅号才支持与微信商户号绑定并用于支付场景‌；普通企业或个人类型的订阅号‌不支持‌开通微信支付功能，也无法通过任何方式关联商户号。Q3、一个微信商户号可以绑定几个appid、授权目录？A：一个微信商户号，公众号支付APPID、小程序APPID合计最多绑定5个；公众号授权目录最多绑定5个。Q4、商户是否可以配置非同主体的appid？A：商户可配置的小程序/公众号主体需要为商户主体、或其微信渠道号主体的appid。Q5、配置appid、授权目录有几种路径？A：有两种方式，①通过【微信商户配置】接口；②合作伙伴控台-商户-商户信息-查看-一体化收款产品-基础支付-微信支付-详情-微信配置，点击配置进入，录入对应的appid、授权目录。Q6、在汇付控台绑定APPID之后是否需前往指定平台进行授权确认。A：通过汇付生成的子商户号，不需要前往指定平台进行授权确认。通过汇付接口、或控台成功绑定APPID之后自动关联成功。Q7、是否支持批量配置APPID？A：不支持，需要给商户一一绑定。Q8、如何获取自身应用的APPIDA：①如果绑定公众号类型的APPID，商户登录公众平台 ，通过路径【设置与开发 -> 开发接口管理 -> 基本配置 -> 开发者ID(AppID)】查看；②如果绑定小程序类型的APPID，商户登录公众平台 ，通过路径【开发与服务 -> 开发管理 -> 开发设置 -> AppID(小程序ID)】查看。二、常见报错1、报错文案： "sub_mch_id与sub_appid不匹配"操作指引：该报错是因为商户appid配置有误，排查如下两个问题：①商户号授权问题：需要确认当前小程序的sub_appid是否已与商户建立绑定关系。若未绑定，可调用【微信商户配置】接口或登录合作伙伴控台进行配置；②参数传递错误：检查请求参数中是否同时存在且正确传递了商户号和sub_appid（当前小程序AppID）2、报错文案：appid绑定提示：该类型Appid暂不支持在API中提交关联操作指引：遇到该报错请登录微信服务商后台进行绑定。另外，微信有政策，针对以下类型的小程序，只能关联微信直联的商户号，无法关联间联的商户号，请核实小程序的类型：①小程序内提供珠宝玉石、3C数码等商品在线销售及配送服务②小程序的账号主体为近一年内新成立的企业及个体户主体③小程序的账号管理员、运营者等角色，与其它高风险小程序存在关联④小程序内经营预售商品

喜报喜报，即日起，汇付天下正式启动【斗拱开发者推荐官活动】。有渠道、有资源的伙伴们可以申请成为开发者推荐官，无需大额投入与繁琐运营，即可赚取收益。开发者推荐官的收益关联所推荐的开发者伙伴带来的交易量，收益叠加且无上限，带来的交易金额越多，推荐官收益越高！（开发者技术伙伴：开发者签约后成为开发者伙伴，获得公司产品/服务的⼿续费底价报价授权，开发者可向商户⾃主定价，底价以上的⼿续费空间归开发者所有。开发者技术伙伴⽀持企业主体与个⼈主体。）（开发者推荐官：要求是企业主体，通过渠道影响⼒为汇付天下推荐开发者技术伙伴，按照推荐效果获得收益。）那么推荐官是如何获得收益的呢，一图说明白推荐官和开发者各自的收益方式：推荐官通过推荐开发者与汇付天下签约，并带来交易量来获取“推荐激励金”。推荐激励金计算方式：---------------------------------------------------------------------------------------------------------------------------------------------------根据推荐官所推荐的开发者伙伴当⽉累积的交易量，推荐官可以收到⼀定⽐例的返点，激励返点分为两档：·基础返点：0.02%；·激励返点：0.01%；激励返点⽣效条件：带来的开发者每个⽉累积的交易量增⻓金额，不低于5%或不低于50万人民币。举个例子：推荐官小强给汇付推荐了3个开发者伙伴（分别叫开发者A、开发者B 、开发者C），开发者A在5月份发展的客户交易了10万，开发者B在5月份发展的客户交易了20万，开发者C在5月份发展的客户交易了50万。那么开发者小强可以获得的基础激励金是 （10+20+50）*0.02%万=160元。如果5月份的交易量对比4月份增长超过了5%，即（4月交易+4月交易*5%）≤160万，则可以还可以额外获得（10+20+50）*0.01%万=80元。总计小强可以获得160+80=240元 的激励金，整个过程只需要分享链接邀请好友来注册开发者，即可每个月稳定获得激励收入。----------------------------------------------------------------------------------------------------------------------------------------------------推荐开发者的操作流程十分简单，省心省力，躺平分钱！首先，在开发者站点注册账号，进入【开发者工作台】即可看到“我的推广”卡片，在卡片点击“查看推广链接”：点击“查看推广链接”后，打开右侧分享链接的生成窗口：每个人可以生成最多20组分享链接，每一组分享链接共有两个页面，一个是带有活动页属性的，有说明的链接，另外一个则就是开发者的认证页面。通过这个链接注册之后的开发者，即可与推荐官绑定，成为推荐官所推荐来的开发者。除了这两种方式，每个推荐官还有一个专属自己的唯一推荐码，开发者在开发者站点自助认证主体的时候，也可以输入推荐码，绑定与开发者之间的关系。[当前版本暂时无法“查看推荐来的开发者”，我们将在下个版本迭代“推荐效果查看”功能]。汇付天下开发者推荐官政策是“轻投入、高回报、零风险、赚不停”的合作模式，诚邀广大与汇付天下并肩拓展开发者生态版图，共掘数字支付新蓝海，躺赚被动收益！

1、登录合作伙伴控台：合作伙伴平台-统一支付平台 2、操作路径：商户-商户信息-点击需要配置的商户号后的“查看”3、点击查看之后，在页面找到一体化支付-基础支付-微信支付中的“详情”按钮4、打开微信配置界面 ，如下：5、点击“微信秘钥配置”可以同时配置 APPID、APP秘钥和支付授权目录附注：   APPID和APPID对应的秘钥，需要在微信公众号或者小程序后台获取；超管登录 https://mp.weixin.qq.com/。路径如下：

合作伙伴控台-配置微信appid.mp4

合作伙伴控台-AT实名认证.mp4

微信实名认证-企业商户第一步：下载微信实名认证二维码1. 请联系您的微信渠道号管理员，扫码登录https://pay.weixin.qq.com/partner/public/home微信渠号管理员：即申请微信渠道号时填写的联系人如未申请微信渠道号，请联系汇付运营获取。2. 渠道商超级管理员，使用微信扫码后，选择对应的微信渠道号进行登录3. 登录后，进入上侧导航栏【合作伙伴功能】，点击左侧菜单栏【特约商户管理】，在右上角找到【下载拓展二维码】（图中标红处）第二步：扫码认证流程企业商户扫码认证流程如下： 1、打开微信 APP，进入【发现】页，点击【扫一扫】2、扫描微信认证二维码3、新商户注册1) 如商户联系人之前未在微信下做过实名认证（如已做过认证，请点击跳转），则出现以下步骤，点击图一下方“微信支付商家注册”小程序，进入图二选择核实商家身份，点击图三“注册商家”。2) 选择对应的营业执照类型并准备相应材料选择完主体，出现如下页面，需要根据客户实际类型选择是否为金融类商户，通常为“否”；3) 填写联系人信息（此联系人可以不是法人，仅作为商户资料上传认证人）4) 上传营业执照，系统会自动识别出相关字段信息，请核对信息是否正确5) 上传法人/经营者证件，系统会自动识别出相关字段信息，请核对信息是否正确6) 如申请单的联系人为非法人，还需要上传联系人证件，系统会自动识别出相关字段信息，请核对信息是否正确7) 全部上传完成后，确认是否有特殊的行业资质，如无特殊，点击未涉及 全部填写完成后，点击“下一步”，微信资料初审后，会到法人认证环节方式一：“向**发送邀请”，需要法人本人已绑卡的微信扫码，完成验证即可；方式二：“汇款到银行账户”，需要填写营业执照的对公账户，对公户汇款微信随机生成的金额至指定账户中，待微信验证完成，微信公众号将推送认证成功信息，即可进入下一步。小 Tips：打款资金将会在第二个工作日退回至对公户中，如未退回，可联系微信热线95017 转2 咨询。7） 完成上述验证后，联系人再次扫微信认证二维码，完成开户意愿确认即可。4、已注册商户认证1) 如果您的商户主体之前已经做过实名认证，则会出现如下界面，点击进入，选择您的商户主体2) 选择对应商户全称旁的小三角，点进详情，在红色框内输入汇付的微信子商户号（如何获取微信子商户号请见手册末尾教程），最后点击“确认无误”即可小 Tips：如果在【我的商家】列表中没有找到对应的商户信息，可以点击“注册新商家”进行重新注册流程，流程同注册新商家跳转.

一、实名认证常见问题Q1：控台实名认证失败了该怎么办呢？A1：您可通过两种方式操作：1）您可以根据控台返回的失败原因，在汇付控台变更资料，然后重新提交；2）建议使用扫拓展码的方式进行实名认证，更方便。Q2：不同主体类型，微信实名认证支持哪些授权方式：A2：1）企业：用法人微信进行扫码授权，或使用“对公账户打款”授权2）小微商户：用小微本人（即法人）的微信进行扫码授权3）其他组织：仅支持“对公账户打款”来授权4）个体工商户：用法人微信进行扫码授权Q3：商户类型为“有限合伙企业”，营业执照和法人信息如何填写？A：营业执照需要合伙双方企业的营业执照拼在一起上传、法人可填写为营业执照上执行事务合伙人的委派代表。Q4：商户法人是境外身份，营业执照法人姓名与护照名称不一致，如营业执照上法人姓名为中文名称，护照名称为英文名，如何填写法人信息？A：1）营业执照法人姓名处和护照名称处均填写为中文（英文），如 张三（zhangsan）;2）提供法人护照翻译件或证明函（证明函可自拟，并加盖公司鲜章），并与护照照片拼图上传于“证件照片正面”处。Q5：商家如何修改联系人信息?A：目前一个营业执照可以绑定多个商家联系人，可由新的联系人发起申请单并完成开户意愿确认。Q6：一个联系人微信号可同时提交多个申请单吗？A：不可以，一个微信只能有一个流程中的申请单，需要完成当前申请流程后才可以申请下一个。Q7：一个微信号可以成为多少个商家联系人吗？A：一个微信号可以成为多个（不限）企业和个体户商家联系人，但是只能成为一个小微商家联系人。Q8：一个营业执照可以绑定多个商家联系人吗？A：可以。Q9：联系人姓名和手机号码一定要是“法人”的吗？A：不一定，但必须是商家指定联系人。Q10：商家提交资料后，可以撤销吗？A：可以。Q11：实名认证审核时效是多久？A：一般为1-3个工作日，请耐心等待。Q12：实名认证支持加急吗？A：一般为1-3个工作日，请耐心等待。Q13：申请单显示已作废/撤销？A：申请单作废一般是您主动点击“撤销申请单”或超过30天未提交导致系统自动作废，如有需要您可通过【“微信支付商家助手”小程序 - 成为商家 - 重新提交申请】。二、实名认证常见报错1、报错文案：交易失败：当前商户需补齐相关资料后，才可进行相应的支付交易，请商户联系对接的微信支付服务商；操作指引：这是因为商户还未进行实名认证，微信和支付宝要求商户需要在入网后完成开户意愿确认，确保商户主体名称不被冒用。商户完成开户意愿确认才可获得支付权限。2、报错文案：当前商户未在微信支付平台完成开户意愿确认，暂时无法进行收款；操作指引：这是因为商户实名认证还没有完成，需要先完成实名认证。3、报错文案：系统错误-当前微信号不是该单联系人请检查后再试操作指引：这是因为这个商家已经通过汇付提交了实名认证的申请单，且当前使用微信号的实名信息与申请单填写联系人信息不一致，需要更换为申请单对应的联系人微信扫码操作。4、报错文案：法定代表人身份信息与公司不匹配，请填写与公司匹配的法人姓名和证件号码。操作指引：1、填写法人姓名中可能存在空格或英文大小写等原因，导致填写的营业执照法人姓名与证件持有人姓名不一致，请检查修改后重新提交。2、如确实没错，有两种方式：1）请反馈到汇付运营，由汇付运营跟微信测核实。如是微信数据错误，微信更新数据后，请商户重新提交并留意审核；2）请使用小程序重复操作三次，系统驳回三次后在小程序上有人工审核提交入口，通过人工审核来提交相关商户资料。5、报错文案：证书时间：登记证书有效期需与数码照/扫描件上一致，如无截止日期默认为长期操作指引：建议您检查一下日期填写是否正确。如确认填写无误，可能是微信侧通道问题，请联系汇付运营帮您反馈微信处理。或参考常见报错4的自助处理方式。6、报错文案：商户号全称与当前商家名称***不一致，无法进行确认，请联系服务商核对商户名称操作指引：1、核对是否选择了正确的主体，若注册多个主体，请选择本次需要处理的主体名称。2、核对商家是否在工商局系统进行了主体名称变更，是的话，请按照流程重新注册主体资料，系统会自动更新主体名称。如无法更新，可联系汇付运营向微信核实处理。或参考常见报错4的自助处理方式。7、报错文案：确认失败，你的身份认证已过期，请前往重新认证。（或者商户点击前往认证后，又循环跳到同样的报错页面）。操作指引：若微信注册商家资料的管理员非法人，开户意愿确认（即微信支付商家注册申请单）有效期为1年，超过1年则需重新注册申请单，待重新注册成功发起授权即可；若微信注册申请单管理员是法人，则无此限制。注：已核实商户号（认证）的不影响8、报错文案：系统错误：当前微信号绑定银行卡的实名信息，与该申请单联系人信息不一致，请检查后再试操作指引：该报错是因为扫码人扫的汇付控台的二维码，且扫码人非指定人。方式一，让指定人扫码认证；方式二，扫拓展码实名。9、报错文案：确认失败，你的商家资料异常，请重新进行注册操作指引：出现该报错原因是此申请单不是由法人提交的，法人和管理员非同一个人，法人没有提交申请单直接扫拓展码进行核实商户号（授权）导致报错，请让创建申请单的管理员扫描拓展码核实商户号（授权）。10、报错文案：确认失败，你的微信号实名信息已变更，请重新进行商家注册操作指引：该报错是因管理员微信更换了实名认证，所以需要对商家进行重新注册，正常情况下，重新注册后再次进行核实商户号（授权）即可。11、报错文案：当前商家需要补充行业经营许可证，请联系服务商重新提交申请单操作指引：当前提供商户号对应的结算规则ID有误，导致出现补充经营许可证页面，请联系服务商修改结算规则ID或重新录入正确结算规则ID的商户号，再扫描渠道商拓展码操作授权，请了解。12、报错文案：当前申请单状态不允许此操作，请稍后再试操作指引：这个报错是因为这个申请单被撤销了，您应该是从之前的推送里面点进去的。如果要实名认证，重新发起即可。13、报错文案：系统错误，该微信号有其他申请单待处理，请先处理完或撤销其他申请单操作指引：需要点进 “商家注册”小程序，看下是否有提示未完成的申请单，需要撤销该申请单才能重新实名认证。14、报错文案：该主体已完成过商家注册，无需重复注册，请撤销该申请单并联系管理员**进行商户号授权。操作指引：该管理员已为该商家提交过注册，请按照页面指引撤销当前申请单，使用管理员当前微信号或名下其他微信号重新扫描渠道商拓展码，进入（门店）商户号授权页面，进行商户号授权。15、报错文案：身份验证失败，您名下账号数量已达上线，无法继续添加操作指引：您好，微信规定同一联系人最多可以帮5个商户进行微信实名认证，可以换一个人进行微信实名认证操作。16、报错文案：微信实名同一联系人只可关联一个小微商户，请更换联系人或商家主体类型。操作指引：您好，按照微信的要求，实名认证的联系人只能帮一个小微商户进行认证，如果该联系人已经认证过小微商户，需要更换联系人再进行微信实名认证。17、报错文案：你所绑定的商户号已达到上限，可解绑不再使用的商户号后再来绑定新商户号。操作指引：您好，一个微信号绑定的商户号上限为200个，可解绑不再使用的商户号后再来绑定新商户号，请了解。18、报错文案：查询商户绑定数量失败，请稍后再试操作指引：您好，请您关闭【“微信支付商家注册小程序“】，删除常用小程序后，再重新打开重试操作，请了解。具体绑定数量情况，可以通过打开【“微信支付商家助手小程序“】 页面查看。19、报错文案：商户号授权失败，请稍后重试操作指引：您好，该情况是因为该主体在进行商户号授权时，单次所选的商户号超过20个，请减少后重试，感谢您的理解与支持。20、报错文案：申请单已被驳回操作指引：这是因为提交的商户资料存在问题，可以点击：“查看详情”看具体原因，然后更新资料重新提交。21、报错文案：证件号码：该商户涉嫌违法违规，暂时无法进行开户/修改信息操作操作指引：该商户可能进入微信违规名单，微信不予合作。为了进一步确认原因，可以提供微信商户号至汇付运营，帮您反馈微信核实。22、报错文案：该服务商下无此商户号，请联系服务商确认操作指引：您好，请核实输入商户号是否有误，若有误请重新输入；若无误，则是商家扫错渠道商拓展码所致（如：该商户号并非属于该渠道商名下）23、报错文案：商户异常交易通知，涉嫌入驻行为异常，调整额度（**）、调整用户向商户可支付额度（**）操作指引：这是因为微信核实到商户号或历史相关的商户号涉嫌异常交易，已被关闭/限制/调整相关功能。如您有申诉意见，请登录微信进入【微信支付商家助手】小程序->风险处理->功能限制记录，找到对应需处理单据，点击“申请解除限制”根据页面提示操作提交申诉，提交材料后7个工作日内留意申诉结果通知。部分情况不支持申诉，请以实际页面提示为准。24、报错文案：商户号有误，请重新输入/商户号格式有误，请确认后再试操作指引：当输入商户号非纯数字，系统自动识别报错，请输入正确商户号搜索。25、报错文案：系统异常，请稍后重试操作指引：您好，请您关闭【“微信支付商家注册小程序”】，删除常用小程序后，再新打开重试操作，请了解。备注：以上内容借鉴了微信官网文档及其他客户案例，侵删。需要了解更多，可以参考微信官方文档，如下：1）商户开户意愿确认流程指引：https://pay.weixin.qq.com/doc/v3/partner/4012064824 2）商家自助完成开户意愿确认操作流程指引：https://kf.qq.com/faq/211220f2uaUr211220UVZ3mM.html3）商家开户意愿指引（FAQ）https://pay.weixin.qq.com/static/help_guide/register_guide.shtml4）腾讯客服小程序-商户入驻咨询

接入文档：商户进件：https://paas.huifu.com/open/doc/api/#/shgl/shjj/api_shjj_qyshjbxxrz_kyc 用户进件（订单分账的时候用这个）：https://paas.huifu.com/open/doc/api/#/yhgl/api_yhgl_qyyhjbxxzc 全渠道资金管理：https://paas.huifu.com/open/doc/api/#/dejy/api_dejy_lztz 全渠道订单分账（需要按门店或者订单分账的接本接口）;https://paas.huifu.com/open/doc/api/#/qqd/api_qqd_ddcx 商户公域授权（需要订单或者门店分账的接本接口）https://paas.huifu.com/open/doc/api/#/kqhx/api_kqhx_gysq_shgysq

一份需求文档，过去要耗费测试工程师数天时间才能转化为一套完整的用例；现在，AI 几分钟就能给出初稿。这不是未来，这是汇付正在发生的现实。一、背景汇付天下是一家深耕支付领域的金融科技公司，研发团队长期面对高频迭代与高合规要求的双重压力。过去几年，汇付持续建设自研的 π 平台，打通了需求、设计、开发、测试、发布、运维全链路，形成了标准化的流程规范与丰富的工具服务体系。然而，传统的测试环节始终存在明显的人力瓶颈：需求量持续增长的同时，测试用例编写依赖个人经验、质量参差不齐，自动化覆盖率难以快速提升，测试执行成为版本发布的卡点。在 π 平台的工程基础之上，我们进一步引入 AI 大模型能力，将其深度嵌入测试全链路——从用例生成到自动化执行，全面提升测试效能。二、让 AI 读懂需求，生成高质量测试用例需求的"黑盒"问题在传统模式下，测试人员拿到需求文档后，往往要经历一个漫长的理解消化过程：文档描述可能模糊，边界条件可能缺失，业务逻辑可能隐含在字里行间。从一份产品需求文档（PRD）到一套完整的测试用例，中间横亘着大量需要依赖个人经验和沟通成本的工作。经验丰富的测试工程师或许能较快建立全局视角，但新人上手则需要更长时间，用例质量也良莠不齐。AI 的介入：需求分析 → 用例生成的闭环汇付利用大模型，构建了一条"需求文档 → 智能分析拆解 → 优化需求 → 自动生成用例"的流水线。第一层：需求文档的智能解析与优化大模型首先对需求文档进行深度阅读，识别功能点、业务规则、前置条件和边界场景，将模糊的自然语言描述转化为结构化的测试点。这一过程不只是格式转换，更是逻辑推理——模型会主动补全需求文档中未明示的隐含规则，发现潜在的逻辑矛盾，输出一份经过"AI 预审"的优化需求文档，作为后续生成用例的高质量输入。例如下图所示需求文档：上传需求文档后执行智能评审：大模型给出具体存在的问题：功能上，上传需求文档之后，交由大模型对文档进行理解，然后基于预设的检查点进行分析，包含“规范性”、“完整性”和“逻辑性”检查，标记存在问题的位置和修改建议，同时给出评分。如果文档质量良好，则评审通过，这一流程结果可以作为需求文档准入的前置条件。如果文档质量欠佳，则退回交由产品经理继续优化。第二层：多维度测试用例自动生成基于优化后的需求文档，大模型可以同时生成两类用例：功能用例：覆盖正常流程、异常流程、边界值、等价类划分，以及容易被人工遗漏的状态冲突场景；接口用例：结合接口文档，自动生成请求参数、断言条件、异常码覆盖等标准化的接口测试用例。使用同一个需求生成的用例如下：以支付场景为例，AI 不仅会生成"正常支付成功"这类主路径用例，还能主动推导"支付金额在审批过程中被修改"、"并发请求下的幂等性验证"、"网络超时后的订单状态一致性"等复杂边界场景——这些恰恰是最容易在人工编写中被忽略、却又往往藏匿着真实缺陷的地方。第三层：人机协作核验与入库AI 生成的用例并非直接投入使用，而是经由测试人员进行核验和进一步优化。这一步的意义在于：测试工程师的业务判断力和经验依然是不可替代的质量守门人，AI 负责"穷举可能性"，人负责"筛选有价值的场景"。核验通过后，用例将存入团队共享的用例库，成为可复用的数字资产，持续积累。这一流程带来的变化是显著的：传统上需要数小时乃至数天才能完成的用例编写工作，如今压缩到分钟级；同时，由于 AI 的系统性推理弥补了人工经验的局限，用例的覆盖度和质量也得到了整体提升。三、让 AI Agent 驱动测试执行，告别手工操作生成用例只是第一步，让测试真正"跑起来"才是效能提升的关键。汇付进一步将 AI Agent 引入测试执行环节，在 UI 自动化和接口自动化两个方向同步发力。UI 自动化：Agent 模拟人工操作的精准执行UI 自动化测试长期以来面临一个共同难题：页面元素频繁变更导致脚本持续失效，维护成本居高不下。AI Agent 的引入改变了这一格局。Agent 能够理解页面的语义结构而非仅依赖固定的元素定位，在界面发生调整时自适应地更新执行策略，大大降低了脚本的脆弱性。UI自动化执行用例的效果如下：与此同时，Agent 可以根据测试用例的描述，自主规划操作路径、执行测试步骤、捕获异常状态，完成从用例输入到执行结果输出的全程自动化。测试人员不再需要逐条手工执行，而是将精力集中在用例设计和结果分析上。接口自动化：从测试脚本到智能化接口覆盖在接口测试层面，AI Agent 能够解析接口文档，自动构造请求参数和断言规则，执行完整的接口覆盖测试。对于金融支付场景下大量的接口调用链路，Agent 可以自动串联上下游接口，模拟真实业务流，发现单点测试难以暴露的集成问题。首先交由Agent解析待测试的接口，根据请求参数的描述去生成相应的测试数据，然后将测试数据保存到待执行的用例中。随后根据场景步骤依此调取测试数据进行执行。执行结果可以看到执行的数据、步骤、成功与失败数。自动产出测试报告，让质量看得见测试执行完成后，系统自动生成结构化的测试报告，涵盖用例通过率、失败用例详情、覆盖率统计、缺陷趋势等关键指标。这些报告不仅是测试结果的记录，也是研发质量的直观度量，帮助项目团队快速决策是否具备发布条件。四、数字背后的效能跃升汇付在测试阶段引入 AI 能力后，整体研发效能的提升体现在多个可量化维度：测试用例生成效率大幅提升，原来需要人工数天完成的用例编写工作，现在借助 AI 辅助可在极短时间内完成初稿，测试工程师将更多精力投入到核验和优化上，单位时间内产出的高质量用例数量显著增加。截至目前，汇付内使用AI生成用例的采纳率在70%以上，相较于传统人工编写方式效率提升10倍以上。用例质量与覆盖度得到系统性改善，AI 推导出的边界场景和状态冲突用例，弥补了人工经验不足带来的覆盖盲区，帮助在上线前发现更多潜在缺陷。汇付的生产缺陷逃逸率一直保持在1%以下，并且逐月下降。生产缺陷逃逸率 = 生产缺陷数 / (生产缺陷数+测试缺陷数)。自动化水平大幅提高，AI Agent 驱动的自动化执行将过去需要大量人力投入的回归测试和接口测试变为常态化运转，测试执行不再是研发节奏的瓶颈。目前汇付的回归测试用例日均运行1000多次。质量反馈周期缩短，自动化执行与测试报告的闭环，让研发团队能够更快获得质量报告，及时响应问题，缩短从发现缺陷到修复验证的整体周期。缺陷修复周期从以往的3天降低到了1天以内，效率提升3倍。五、AI 赋能测试的本质汇付在测试环节的 AI 实践，揭示了一个共同的底层逻辑：AI 的价值不在于替代测试人员，而在于将测试工程师从重复性、机械性的工作中解放出来，让人的经验和判断力聚焦在真正有价值的地方。AI 负责穷举可能性，人负责筛选有价值的场景；AI 负责执行标准化动作，人负责设计测试策略和把控质量标准。这种人机协作分工，才是 AI 赋能测试的真正形态。而汇付能够走到这一步，π 平台的积累功不可没。标准化的流程规范、丰富的工具服务、结构化的数据资产，是大模型能力得以落地的土壤。没有扎实的工程基础，AI 的叠加只会是空中楼阁。站在今天的节点回望，汇付在 AI 测试上的探索，并非终点，而是一个持续演进的起点。随着大模型能力的不断迭代，以及与 π 平台更深层次的融合，测试的智能化将走向更广阔的边界——更主动的缺陷预测、更深度的业务理解、更自治的测试决策，都将在不远的未来成为现实。

在当前的AI技术（尤其是大语言模型和AI Agent）的语境下，Skill 通常指的是一个可复用的、专门针对某个特定任务的能力模块。你可以把它通俗地理解为给AI安装的“插件”或“应用”。具体来说，可以从这几个层面理解：核心目的：让通用的AI模型（比如一个只会聊天的AI）能完成非常具体、专业的事情。比如，一个通用的AI可能不知道如何操作你的公司内部软件，但安装了对应的Skill后，它就能做到了。它包含什么：一个Skill不仅仅是“一段指令”，它通常是一个完整的包，可能包括：指令（Prompt）：告诉AI执行这个任务的规则和步骤。代码（Code）：需要运行的具体逻辑（比如Python代码）。API调用：如何连接外部工具（如查询天气、发送邮件、操作数据库）。知识库：需要参考的专业文档或数据。实际例子：天气查询Skill：当你说“今天天气怎么样”，这个Skill会识别意图、调用天气API、解析返回的数据，最后用自然语言告诉你结果。代码生成Skill：专门针对Python、Java等特定语言的代码生成、解释和调试，包含该语言的语法规则和最佳实践。PPT生成Skill：你给它一个主题，它能自动规划大纲、搜索数据、生成图表，最后输出一个完整的PPT文件。会议纪要Skill：提取录音文本中的关键点、决策和待办事项，并按标准格式输出。与传统编程的区别：传统函数：你需要精确告诉它怎么做（写死每一步）。Skill：你只需要告诉它做什么（描述目标），AI利用其推理能力来动态决定如何组合和执行步骤来完成目标。为什么重要？把强大的AI能力“模块化”、“工具化”，让AI从一个只会聊天的“大脑”，变成一个能动手做事的多面手助手。你可以通过添加或移除不同的Skill来定制AI的能力，就像给手机安装或删除App一样。总结一句话：Skill就是让AI从“什么都会一点”变成“在某些具体任务上非常专业”的、可插拔的功能组件。

Stripe的故事，要从两个爱尔兰兄弟说起。哥哥帕特里克·科里森，1988年出生在爱尔兰西南部的利默里克郡。他8岁就在利默里克大学旁听计算机课程，10岁开始编程。16岁那年，他参加爱尔兰青年科学家与技术展览会，凭一个人工智能项目拿了冠军。弟弟约翰比帕特里克小两岁，同样是个天才。17岁那年，哥俩搞了一家公司叫Auctomatic，帮eBay卖家管理拍卖。不到一年，这公司以500万美元的价格被收购了。那一年，帕特里克19岁，约翰17岁，成了白手起家的百万富翁。但兄弟俩没拿着钱去享受人生。卖掉Auctomatic之后，帕特里克去了麻省理工，约翰去了哈佛，他们一边上大学，一边捣鼓各种项目。在这个过程中，他们发现了一个极其痛苦、但大家都不愿意碰的问题：在线支付。当时是2009年前后，那时候我国也没有快捷支付，这么一说你就懂了，支付要跳到银行网银，插上u盾，下载证书兄弟俩意识到一个问题：在线支付的基础设施是断裂的。它应该像播放视频一样简单，几行代码就能搞定。但现实是，它复杂得简直是要了亲命了。Paul Graham管这个叫厌恶性盲区，就是那种问题很大、需求很强，但因为过程太枯燥、太繁琐，聪明人都不愿意碰的领域。Collison兄弟偏偏就扎进了这个盲区。他们的想法很简单：做一个支付版的Slicehost。Slicehost是什么？一个让开发者能轻松部署服务器的服务。他们想做同样的事，让开发者能轻松接入支付功能。2009年，兄弟俩说干就干。他们给公司起了个名字，特别极客：/dev/payments。这个名字在程序员眼里很酷，但问题也很明显，口头交流的时候，你根本没法跟人解释清楚这个斜杠到底在哪。而且银行家们对这个名字也特别反感。后来团队决定改名。在同事Greg Brockman的最后通牒下，他们选了一个新名字：Stripe。简洁，暗示信用卡的磁条，又好记。这个名字就这么定了下来。  名字定了，业务怎么跑起来？ Stripe的第一个难题是：怎么搞定银行？毕竟支付公司离不开银行合作。Collison兄弟虽然是编程天才，但他们对怎么跟银行打交道这件事，几乎一无所知。 这时候，有人给他们推荐了一个人：Billy Alvarado。 Billy是什么来头？斯坦福MBA，之前在SEVEN Networks当过产品和工程副总裁。但问题是他不会写代码。 对Stripe这样一家以开发者为中心的公司来说，雇一个不会写代码的人，这事让Collison兄弟很纠结。帕特里克后来回忆说：他不会写代码。 不过最后他们还是雇了Billy。事实证明，这是个明智的决定。 两个月内，Billy搞定了富国银行。Stripe终于有了第一个银行合作伙伴。 产品出来后，第一个客户是谁？280 North公司的Ross Boucher。第一笔交易金额是多少？40美元。后来Boucher加入Stripe，他说：我没想到Stripe会变得这么大。 从这40美元开始，Stripe通过YC的人脉网络，慢慢积累了几十个客户。帕特里克后来说，产品与市场的契合度几乎是瞬间被证明的。

原因说明： 调用微信支付接口时报此错误，一般是因为商户还没有完成微信实名认证（支付宝也有类似情况） 解决方法： 1）通过汇付服务商控台提交实名认证，具体路径：商户管理-商户支付功能管理-实名认证 2）通过调用实名认证接口提交实名认证，接口地址：微信实名认证 3）通过扫服务商拓展码完成认证，可在企微对接群中联系汇付运营或对应服务商