# @hanzo/pay 中文文档

规范地址：https://npmcn.com/package/%40hanzo/pay/

版本：0\.1\.2
npm 元数据更新时间：2026-09-30T08:30:34.905Z
中文译文更新时间：2026-11-17T08:46:20.384Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40hanzo/pay
原文对照：https://npmcn.com/package/%40hanzo/pay/?lang=original
项目主页：https://github.com/hanzoai/pay#readme
源码仓库：https://github.com/hanzoai/pay

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：87.8 kB，22 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：react-native-square-in-app-payments \>=2
- 首次发布：2026-08-05T02:31:21.031Z
- 最新版本发布：2026-09-30T08:30:34.484Z
- 近 30 天下载量：5031（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 3 个）

## 中文简介

一个界面后面的网络和本地化的平方付款 。 卡片,Apple Pay,Google Pay,Cash App Pay,ACH和礼品卡,特征被探测到——有一个彩色的桌子,将网络iframe和原生的活页都穿好.

## 安装

```sh
npm install @hanzo/pay
```

也可以使用：`pnpm add @hanzo/pay`、`yarn add @hanzo/pay`、`bun add @hanzo/pay`

## README

# @hanzo/付费

网络和本土的平面支付, 在一个界面后面.

```
pnpm add @hanzo/pay
```

## 形状

三入门. 根由是平台不可知和无依赖性——契约 颜色表,一能键规则——所以是一个服务器,一个共享模块和一个测试 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}能撑住的 适配器明确:

| 条目 | 需求 | 给你 |
| --- | --- | --- |
| `@hanzo/pay` | 无 | `Terminal`, (中文(简体) ), `Method`, (中文(简体) ), `Tender`, (中文(简体) ), `Token`, (中文(简体) ), `PALETTE`, (中文(简体) ), `legible`, (中文(简体) ), `attempt` |
| `@hanzo/pay/web` | 浏览器 | `terminal()` 在网络支付SDK, `style()`, (中文(简体) ), `pin()` |
| `@hanzo/pay/native` | `react-native-square-in-app-payments` | `terminal()` 在App支付SDK, `appearance()` |

两个适配器导出 `terminal(config)` 和两者返回相同的 `Terminal`。 。 。 . 用文件名来挑选一个魔法,直到一个捆绑者找到另一个, 然后在运行时失败,在付款时,在别人的装置上——所以 主机表示它是哪个平台,在导入中.

## 收钱

```ts
import { cancelled, attempt } from '@hanzo/pay'
import { terminal } from '@hanzo/pay/web'

const pay = await terminal({ applicationId, locationId, environment })
const tender = { total: { amount: '12.00', currency: 'USD' }, country: 'US', label: 'Credit' }

const rails = await pay.offers(tender)     // only what can really pay, here, now
await pay.mount?.('card', '#card')          // absent on native: there is no element

const key = attempt()                       // hold this across retries
try {
  const token = await pay.collect('card', tender)
  // charge server-side with token.value and `key` as the idempotency key
} catch (e) {
  if (!cancelled(e)) throw e                // a dismissed sheet is not a failure
}
```

**这个包裹从来不动钱.** 每个铁路都以单一用途的标志结束 充电是服务器的电话.

## 它知道,否则你会 学习艰难的方式

-   **`offers()` 问SDK,一次一个铁道.** 可用性取决于 浏览器、设备、 买家保存的卡片 _财务报告和审定财务报表_ 商户账户 铁路开通了 列出平台无法使用的钱包的拾取器 一个死胡同,上面有标志.
-   **`REACH.native` 没有现金支付和ACH.** Square的本地SDK飞船 也没有。 这是伸展范围,不是政策——东道主可能会降低本表的轨道 清单,以及 `hanzoai/pay` 在广场上降低ACH,因为它的顶端点 收费成功时借项数日后结算.
-   **之前没有等待什么 `tokenize()`。 。 。 .** 苹果拒绝未打开的工作表 想要的手势,所以 `offers()` 在前面铺起所有的栏杆 `collect()` 只读地图。 一个流浪汉 `await` 在呼叫中断时上方 付与无别.
-   **Cash App Pay和ACH在一次活动上交付,而不是回报值.** 打电话的人 默默地读到只有回报 才能收到任何报酬 成功 .
-   **`pin()` 是为您申请的.** `input.backgroundColor` 被接受,然后 已忽略 : `color-scheme` 继承到跨原生 Iframe 和 UA 涂料 控制SDK的状态 一条规则解决它,它必须 在卡片贴上前放在纸上 `terminal()` 放在那边 而不是留下样式表,您可以忘记导入。 它带着花花环 也是因为镜像的原因: 球场外画出个戒指 所有广场都会为你作风 在球场边缘停车 打电话 `pin()` 只有你开车 `payments.card()` 直接代替 `Terminal`。 。 。 .
-   **`attempt()` 适合广场的统治者.** 一个 `idempotency_key` 超过45个字符是 在批准前被拒绝。 一个36Char的UUID在下方 `topup:<org>:` 包装是 49,它失败了每张org的卡费,并读作"充电失败".
-   **`Detail.charge` 将本地工作表打开.** Square 本地纸牌 在铸造了符牌后继续工作,然后被告知是否指控 已起作用——因此,已到位的跌价折返,而不是将买方倒向 空为表. 网无等相而罔取.

## 他们

一个 `Palette` 两个平台的衣服: `style()` 让它成为CSS的文字 网络iframe的, `appearance()` 作为 `{r,g,b,a}` 包含本地 床单需要。 表面都无法读取您的 CSS 变量, 一个是交叉源, 另一个不是网络——这就是为什么桌子上有文字.

```ts
import { legible, PALETTE } from '@hanzo/pay'

legible(PALETTE.dark)                        // [] — every contrast floor met
legible({ ...PALETTE.dark, field: '#fafafa' }) // names the pairs that fail
```

运行 `legible()` 在发货前用一个牌子调色板 一个评论家看着一个 暗模拟不能分出 2.6: 1 从 4.4: 1, 焦点环是 WCAG 2.4.11 要求而不是偏好.

**设定 `field` 财务报告和审定财务报表 `border` 输入量,按 浏览器.** 纸牌条落在你田地的一栏中 读作其中之一 它们或作为外国物体;没有第三种结果。 我们的货运过来了 `--card` 和它的发线—— 真正的代号,为一张卡, 所以条子做了一个打火机 地面后面的边缘比上面的每个地都更微弱.

**`ring` 是一个焦点指标,框不移动.** `pin()` 画出来 在容器周围作为轮廓, 所以这是相同的环 你页已经设置 \* 自行控制; `style()` 因此,画的FOCUSED发线休息 颜色,因为 Square 花费了两次(边框和 a) `::before` 环 其外的一个像素),其他任何值都是第一环内的第二个环.

## 本地设置

`@hanzo/pay/native` 需求 `react-native-square-in-app-payments` 以及当地人 构建插件文档的步骤( APLL Pay 应享权利和商号 ID, Google) 通过游戏服务付费). `appearance()` 实值 **仅iOS** -Android的卡片条目是 在构建时通过本地的 XML 样式, 没有运行时频道 .

## 许可证

阿帕奇 - 2.0

## 常见问题

### @hanzo/pay 是什么？

一个界面后面的网络和本地化的平方付款 。 卡片,Apple Pay,Google Pay,Cash App Pay,ACH和礼品卡,特征被探测到——有一个彩色的桌子,将网络iframe和原生的活页都穿好\.

### 如何安装 @hanzo/pay？

在项目目录运行 npm install @hanzo/pay，或使用 pnpm add / yarn add / bun add。

### @hanzo/pay 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @hanzo/pay 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @hanzo/pay 可以商用吗？

@hanzo/pay 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @hanzo/pay 的下载量有多少？

根据 npm 官方下载统计，@hanzo/pay 在 2026/10/17 – 2026/11/15 这 30 天内被下载 5,031 次，日均约 168 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @hanzo/pay 还在维护吗？

最新版本 0\.1\.2 发布于 2026/09/30（1 个月前）；至今共发布 3 个版本，其中过去 12 个月发布了 3 个；首次发布于 2026/08/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

