@hanzo/pay

中文文档
0.1.2发布于 2026/09/30Apache-2.0TypeScriptESM + CJS零依赖近 30 天下载 5031

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

中文使用文档
文档目录6 节
  1. 形状
  2. 收钱
  3. 它知道,否则你会 学习艰难的方式
  4. 他们
  5. 本地设置
  6. 许可证

@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/nativereact-native-square-in-app-paymentsterminal() 在App支付SDK, appearance()

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

收钱

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 变量, 一个是交叉源, 另一个不是网络——这就是为什么桌子上有文字.

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 共发布 3 个版本,首次发布于 2026/08/05;过去 12 个月发布了 3 个版本。

版本发布日期距今
0.1.2latest2026/09/301 个月前
0.1.12026/08/272 个月前
0.1.02026/08/053 个月前

关于 @hanzo/pay 的常见问题

@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 和提交记录判断。