# 42-cent-base 中文文档 规范地址：https://npmcn.com/package/42-cent-base/ 版本：1\.0\.1 npm 元数据更新时间：2022-10-03T13:24:26.152Z 中文译文更新时间：2026-11-06T11:22:30.614Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/42-cent-base 原文对照：https://npmcn.com/package/42-cent-base/?lang=original 项目主页：https://github.com/continuous-software/42-cent-base#readme 源码仓库：https://github.com/continuous-software/42-cent-base ## 关键信息（来自 npm 元数据） - 包体积（解压后）：33.9 kB，11 个文件 - 模块格式：CommonJS - TypeScript 类型：未声明 - 运行依赖：1 个 - 首次发布：2014-09-16T21:39:26.712Z - 最新版本发布：2019-07-22T08:25:23.787Z - 近 30 天下载量：3393（2026-10-04 至 2026-11-02，npm 官方下载统计） - 已发布版本数：14（近 12 个月 0 个） ## 中文简介 42分适配器的结构接口 ## 安装 ```sh npm install 42-cent-base ``` 也可以使用：`pnpm add 42-cent-base`、`yarn add 42-cent-base`、`bun add 42-cent-base` ## README # 42分基数 [![Greenkeeper badge](https://badges.greenkeeper.io/continuous-software/42-cent-base.svg)](https://greenkeeper.io/) > 节点.js API抽象支付网关. 由列表中支持的网关使用 [42美分(42%)](https://github.com/continuous-software/42-cent)。 。 。 . ## [语义版本](http://semver.org/) 需要注意的是,BaseGateway API将遵循语义版本规则,这样: - 已定义属性的任何更改将定义一个新的 API, 从而导致 BaseGateway 版本的首位数不同 - 新的支持参数/方法将定义一个新的功能,因此将得出BaseGateway版本的第二位数 - Bug 修正/ patches 不应影响网关执行, 并将导致 BaseGateway 版本的第三个位数 ## BaseGateway API 页面存档备份,存于互联网档案馆 - [`**basegateway()**`](https://npmcn.com/package/42-cent-base/#readme-ctor) - [`**basegateway#submitTransaction()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_submitTransaction) - [`**basegateway#authorizeTransaction()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_authorizeTransaction) - [`**basegateway#getSettledBatchList()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_getSettledBatchList) - [`**basegateway#refundTransaction()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_refundTransaction) - [`**basegateway#voidTransaction()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_voidTransaction) - [`**basegateway#createSubscription()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_createSubscription) - [`**basegateway#createCustomerProfile()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_createCustomer) - [`**basegateway#getCustomerProfile()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_getCustomerProfile) - [`**basegateway#chargeCustomer()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_chargeCustomer) * * * #### 基门道( 选项) * * * #### basegateway# 提交交易( 订单、 信用卡、 前景 \[, 其他\]) 授权并获取交易. #### `parameters` `order` _(标 题)_ - `'amount'` _(弦声)_:交易金额. `'creditCard'` _(标 题)_ - `'creditCardNumber'` _(弦声)_:信用卡(PAN)号码. - `'expirationMonth'` _(弦声)_:信用卡到期月份. - `'expirationYear'` _(弦声)_:信用卡到期年份(2或4位数字). - `'cvv'` _(弦声)_:信用卡安全码(3或4位数字). `prospect` _(标 题)_ - `'customerFirstName'` _(弦声)_:客户名(也用于计费). - `'customerLastName'` _(弦声)_:客户的姓氏(也用于记帐). - `'customerEmail'` _(弦声)_:客户的电子邮件. - `'billingAddress'` _(弦声)_:账单地址. - `'billingCity'` _(弦声)_: 比林市 - `'billingState'` _(弦声)_: 计费州 - `'billingZip'` _(弦声)_: 计费 - `'billingCountry'` _(弦声)_: 计费国 - `'shippingFirstName'` _(弦声)_数字 : - `'shippingLastName'` _(弦声)_数字 : - `'shippingAddress'` _(弦声)_数字 : - `'shippingCity'` _(弦声)_数字 : - `'shippingState'` _(弦声)_数字 : - `'shippingZip'` _(弦声)_数字 : - `'shippingCountry'` _(弦声)_数字 : `other` _(标 题)_ 网关 SDK 执行中特有的其它字段. 详情请参考具体的SDK. #### `return value` 回返a `Promise` 因而也带有下列对象: - `'transactionId'` _(弦声)_:交易的独特标识符. - `'authCode'` _(弦声)_: 银行机构的授权代码. - `'_original'`:来自网关的原始回应. 如果承诺因为网关而被拒绝, 原因是 `object` gatewayError 有下列属性的例子 : - `'message'` _(弦声)_: 来自网关的错误消息 . - `'_original'`: Sdk具体执行的原始回应. 否则,这将是一个例子 `Error`。 。 。 . * * * #### basegateway# 授权交易( 订单、 信用卡、 前景\[, 其他\]) 收买一笔交易. #### `parameters` 见 [`**basegateway#submitTransaction()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_submitTransaction)。 。 。 . * * * #### basegateway# getsSettledBatchList(从,到) 获取时间窗口内已结算交易的批次列表 #### `parameters` `from` _(日期)_: 下限. `to` _(日期, 默认值 : `Date.now()`(中文(简体) )_: 上限. #### `return value` 回返a `Promise` 因而也带有下列对象: - `'batchList'` _(箭头)_: 一组批次,其中批次有以下字段. - `'batchId'`:批次的id通过网关内部系统引用. - `'settlementDate'` _(弦声)_: 结算日期时间(UTC)的字符串. - `'chargeAmount'` _(弦声)_: 时间窗口内收取的交易总额. - `'chargeCount'` _(弦声)_: 时间窗口内收费交易的总计分. - `'refundAmount'` _(弦声)_: 时间窗口内退款交易的总额. - `'refundCount'` _(弦声)_: 时间之窗内退款交易总数. - `'voidCount'` _(弦声)_: 时间窗口内已作废的交易总数. - `'declineCount'` _(弦声)_: 时间窗口内已作废的交易总数. - `'errorCount'` _(弦声)_: 时间窗口内已作废的交易总数. * * * #### basegateway# 退款交易( 交易集, 选项) 退款(或信贷)一项已结算的交易. #### `parameters` `transactionId` _(弦声)_: ID 引用交易在网关退款. `options` _(标 题)_: 一组可选字段. - `'amount'`:应退还的金额(用于部分退款). #### `return value` 回返a `Promise` 因而也带有下列对象: - `'_original'`:来自网关的原始回应. 如果承诺因为网关而被拒绝, 原因是 `object` gatewayError 有下列属性的例子 : - `'message'` _(弦声)_: 来自网关的错误消息 . - `'_original'`: Sdk具体执行的原始回应. 否则,这将是一个例子 `Error`。 。 。 . * * * ### basegateway#void 交易( 交易集 \[, 选项\]) 进行非固定交易. #### `parameters` `transactionId` _(弦声)_: id引用交易在网关上无效. `options` _(标 题)_: 一组可选字段. #### `return value` 回返a `Promise` 因而也带有下列对象: - `'_original'`:来自网关的原始回应. 如果承诺因为网关而被拒绝, 原因是 `object` gatewayError 有下列属性的例子 : - `'message'` _(弦声)_: 来自网关的错误消息 . - `'_original'`: Sdk具体执行的原始回应. 否则,这将是一个例子 `Error`。 。 。 . * * * #### basegateway# 创建订阅(信用卡、 前景、 订阅) 计划\[,其他\] 创建一个经常性的付款. #### `parameters` **信用卡**: CreditCard QQ对象,与支付相关的信用卡 **前景**: Prospect QQ对象,与订阅相关的前景/客户 **订阅计划**: 订阅计划 QQ对象,订阅计划 注意:Tuple\[周期单位\],周期Length\]必须产生一个有网关执行支持的时期,否则,单位应优先使用 **其他项目**: Object, 一组供特定执行使用的选项 #### `return value` 回返a `Promise` 因而也带有下列对象: - `'subscriptionId'`: 网关上的订阅标识. - `'_original'`:来自网关的原始回应. * * * #### basegateway# createCustomer Profile(付款、计费、航运、其他) 在网关中创建客户简介,对客户收取费用有用,而无需再次提供其支付方法信息. #### `parameters` **付款**: 信用卡QQ对象,支付信息与客户关联 **账单**: 对象,与客户联系的账单信息 **航运**: 与客户有联系的物品、运输信息 **其他项目**: 对象, 与特定网关执行相关的可选信息 #### `return value` 回返a `Promise` 因而也带有下列对象: - `'profileId'`: 客户简介的参考ID. - `'_original'`:来自支付网关的原始回应. * * * #### 基础门道# getCustomeProfile( profileId) 获取先前保存的客户简介 . #### `parameters` `profileId` _(弦声)_: ID在网关中引用客户简介. #### `return value` 回返a `Promise` 因而也带有下列对象: 如果解决了这个承诺,那么这个字段与前景实例加字段相同 `payment` 持有信用卡 * * * #### 基口道# 充电库( 顺序, 前景 \[, 其他\]) 使用客户简介提交交易(授权和抓取). #### `parameters` **顺序**: 对象,命令信息 **前景**: 前景简介,要收费的前景简介,注意前景必须有外地简介Id设定 **其他项目**: 对象, 与特定网关执行相关的可选信息 #### `return value` 见 [`**basegateway#submitTransaction()**`](https://npmcn.com/package/42-cent-base/#readme-basegateway_submitTransaction)。 。 。 . ## 常见问题 ### 42-cent-base 是什么？ 42分适配器的结构接口 ### 如何安装 42-cent-base？ 在项目目录运行 npm install 42-cent-base，或使用 pnpm add / yarn add / bun add。 ### 42-cent-base 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/42-cent-base 是否存在。 ### 42-cent-base 支持 ESM 还是 CommonJS？ 以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。 ### 42-cent-base 可以商用吗？ 42-cent-base 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### 42-cent-base 的下载量有多少？ 根据 npm 官方下载统计，42-cent-base 在 2026/10/04 – 2026/11/02 这 30 天内被下载 3,393 次，日均约 113 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### 42-cent-base 还在维护吗？ 最新版本 1\.0\.1 发布于 2019/07/22（7 年前）；至今共发布 14 个版本，其中过去 12 个月发布了 0 个；首次发布于 2014/09/17。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。