开源技术

汇付支付斗拱 C# 语言 SDK（bspay-csharp-sdk）

其宝 — Wed, 13 May 2026 08:49:29 GMT

C# SDK 简介为了提高客户接入的便捷性，本系统提供 SDK 方式接入，使用本 SDK 将极大的简化开发者的工作，开发者将无需考虑通信、签名、验签等，只需要关注业务参数的输入。 SDK 项目结构说明BasePaySdk -- SDK核心包, 包含通信, 加解签, 接口参数对象等BasePayDemo -- 接口调用/参数赋值演示demolib -- 第三方引用SDK 接入说明以下两种方式任选其一直接在项目.csproj文件中引用(version 版本建议使用当前最新版) 直接下载源码文件, 将BasePaySdk(SDK核心包)源码放入项目中SDK 使用说明接口命名直接根据接口URL来命名, 方便用户使用, 需要使用某接口时, 可直接使用接口中文名, 或接口URL(驼峰格式)进行搜索, 找到对应的request, demo等配置初始化初始化为全局配置(多商户模式下, 可初始化多份, 参考demo中方法) InitMerConfig.init(); 组装请求参数为了接口使用更加方便, 我们将参数粗分为必填/非必填, 必填直接放在类中, 非必填放在extendInfos字段中 // 2.组装请求参数 V2MerchantBasicdataQueryRequest request = new V2MerchantBasicdataQueryRequest(); // 请求流水号 request.setReqSeqId(DateTime.Now.ToString("yyy-MM-dd HH.mm.ss.fff")); // 请求日期 request.setReqDate(DateTime.Now.ToString("yyyyMMdd")); // 汇付客户Id request.setHuifuId("6666000108854952"); // 设置非必填字段 Dictionary extendInfoMap = getExtendInfos(); request.setExtendInfo(extendInfoMap); 发起API调用 // 3. 发起API调用 Dictionary result = null; result = BasePayClient.postRequest(request, null);

汇付支付斗拱收银台 JavaScript 语言 SDK（dg-js-sdk）

其宝 — Wed, 13 May 2026 08:47:58 GMT

收银台 js sdkRepository：https://github.com/huifurepo/dg-js-sdk简介收银台 SDK，是基于支付托管模式，商户需开通支付托管功能。SDK 支持支付宝、微信、云闪付等多种支付方式。同时能根据需求高定制化的配置页面样式。封装收银台页面以及独立支付按钮等功能组件，通过 npm 包的形式分发和引入，帮助商户无感对接支付。降低商户接入支付的复杂性。改变原有支付托管跳转页面的接入方式，只提供支付功能的组件或按钮，允许商户侧自己定制实现收银台页面。实现页面高定制化的需求。开发者通过创建 'checkout' element 创建页面组件，然后将其渲染到页面上，同时传入 callback 方法用来接收处理事件结果。默认包含支付宝，微信，云闪付三种支付方式。根据环境展示支付方式，支付宝内只展示支付宝，微信内只展示微信，云闪付只展示云闪付。系统默认浏览器展示支付宝与微信。H5页面效果图PC页面效果图流程说明如果是 ATU App 内浏览器访问页面。如果是微信 app，跳转授权页面，获取 authcode 下单。发起支付。（微信内走公众号支付流程，结果页）如果是支付宝 app，下单 A_native 正扫方式，拉起，支付。如果是云闪付，跳转授权页面，获取 authcode，点击支付按钮，下单，发起支付。如果是手机系统自带浏览器，选择微信支付，跳转微信托管小程序，完成支付。H5 页面轮询获取支付结果，返回支付结果给调用方。选择支付宝支付，跳转支付宝，下单 A_native 正扫方式，拉起，支付。H5 页面轮询获取支付结果，返回支付结果给调用方。不支持云闪付。如果是PC 端浏览器，展示支付方式对应的支付二维码，用户扫描二维码完成支付。支付逻辑同手机端相同。接入说明服务端对接支付sdk是基于支付托管模式的，商户需开通支付托管功能，并且商户服务端需对接预下单接口，并提供前端接口给前端调用。接口文档参见预下单接口（注意：H5/PC页面预下单选择要根据环境判断，如果是ATU app内预下单pre_order_type = 1；如果是在商户自己App，或者是系统默认浏览器里面是通过跳转小程序的方式完成支付的，所以如果在非ATU环境下，选择微信的话 pre_order_type=3，选支付宝预下单 pre_order_type= 2）前端对接准备1，远程下载并安装sdknpm install dg-element 或下载sdk 包 1.0.02，引入sdkimport { HFPay } from 'dg-js-sdk'; 3，判断环境如渲染单一支付按钮组件，需先判断当前环境是否支持/** * @Description: 判断是否是微信浏览器 */ function isWXJS() { return navigator && navigator.userAgent.toLowerCase().indexOf('micromessenger') > 0; } /** * @Description: 判断是否是支付宝浏览器 */ function isAliPayJS() { return navigator && navigator.userAgent.toLowerCase().indexOf('alipayclient') > 0; } /** * @Description: 判断是否是银联浏览器 */ function isUnionPayJS() { return navigator && navigator.userAgent.toLowerCase().indexOf('unionpay') > 0; } /** * @Description: 判断是否是web环境 */ function isWebEnv() { return !/Android|webOS|iPhone|iPod|Phone|Mobile|OpenHarmony|BlackBerry/i.test(navigator.userAgent); } 4，定义预下单方法通过服务端接口获取预下单号，定义方法，供后续传入sdk，sdk 内会调用该方法获取预下单号。以下为代码示例，具体调用以商户侧为准，但返回数据格式需与示例一致。需包含 pre_order_id、huifu_id、req_seq_id、req_dateconst createPreOrder = async function (selectedType) { // 增加loading 弹框 document.getElementById('loadingMask').classList.remove('hide'); const requestBody = { huifu_id: '6666000109133323', req_seq_id: Date.now().toString(), trans_amt: document.getElementById('element-amount').value, time_expire: '300', pre_order_type: '1', goods_desc: '无线鼠标静音无声笔记本台式电脑', hosting_data: { project_title: 'DEMO演示-无模板', project_id: 'PROJECTID2023092518673961', callback_url: 'http://paas.huifutest.com/checkout/demo/h5/jsSDKDemo.html', } }; if (isAliPayJS() || isWXJS() || isUnionPayJS() ) { requestBody.pre_order_type = '1'; } else if (selectedType === 'alipay') { requestBody.pre_order_type = '2'; requestBody.app_data = { app_schema: 'app_schema', } } else if (selectedType === 'wechatpay') { requestBody.pre_order_type = '3'; requestBody.miniapp_data = { need_scheme: 'Y', } } try { const response = await fetch(`https://checkoutbff.cloudpnr.com/v1/payment/pre/create`, { method: 'POST', headers: { 'Content-Type': 'application/json', // 建議加上 Header }, body: JSON.stringify(requestBody), }); const data = await response.json(); console.log('預下单结果:', data); // 隐藏loading 弹框 document.getElementById('loadingMask').classList.add('hide'); loadingFlag = false; return { pre_order_id: data.json_data.pre_order_id, req_seq_id: data.json_data.req_seq_id, huifu_id: data.json_data.huifu_id, req_date: data.json_data.req_date, }; } catch (err) { // 隐藏loading 弹框 $('#loadingMask').hide(); console.error('預下單失敗:', err); // 將錯誤向上拋出，讓調用者也能處理 throw err; } } 5，创建收银台 element，将组件渲染到页面上方法调用const { error, hfPay } = await HFPay(); hfPay.component(elementName,{ createPreOrder: createPreOrder, callback:callback }); 参数说明 |参数 | 类型 |说明 | |:--------|:------------|:-------------| | elementName | 字符串 | element 类型，checkout| | createPreOrder | function | 创建预下单的方法，需返回预下单号，具体参见调用示例| | callback | function | 回调方法，一般处理报错信息|调用示例：function callback(result) { console.log('callback 返回' + JSON.stringify(result)); // {"type":"payment_data","data":{"transStat":"1","huifuId":"6666000109133323","reqSeqId":"1753150933645","reqDate":"20250722","respDesc":"操作成功"}} } let element = hfPay.component('checkout', { createPreOrder: createPreOrder, callback:callback }); if (element) { element.mount('#element-container'); } else { console.log(`App: SDK 未能創建組件`); } 6，创建单支付按钮 element，将组件渲染到页面上除了创建整个checkout组件，还可以创建单支付按钮组件，支持支付宝、微信、云闪付三种支付方式方法调用const { error, hfPay } = await HFPay(); hfPay.component(type, { createPreOrder: createPreOrder, callback:callback }); 参数说明 |参数 | 类型 |说明 | |:--------|:------------|:-------------| | elementypetName | 字符串 | 单支付按钮类型，枚举值，alipay、wechatpay、unionpay| | createPreOrder | function | 创建预下单的方法，需返回预下单号，具体参见调用示例| | callback | function | 回调方法，一般处理报错信息|7，处理回调{ "type":"payment_data", "data":{ "transStat":"1", "huifuId":"6666000109133323", "reqSeqId":"1753150933645", "reqDate":"20250722", "respDesc":"操作成功" } } 常见问题Q1：如何给支付按钮定制样式A：可直接通过按钮class name 进行css 样式定制Q2：微信支付宝是怎么实现支付的A：如果在ATU 环境中，点击支付，页面会跳转到支付页面。如果在非ATU 环境中，点击支付，会拉起小程序进行后续支付操作。SDK版本记录版本日期版本说明v1.0.02025/8/28初始版本，支持微信支付宝云闪付支付

汇付支付斗拱线下账单支付 vue 组件库（dg-bill-plugin）

其宝 — Wed, 13 May 2026 08:46:26 GMT

线下账单支付 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 文件中，直接使用组件库标签

汇付支付斗拱 Python 语言 SDK（dg-python-sdk）

其宝 — Wed, 13 May 2026 08:44:58 GMT

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 组件库（dg-dashboard-sdk）

其宝 — Wed, 13 May 2026 08:42:01 GMT

汇付支付斗拱商户 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) }); 在页面中写入可引入相关组件：