Skip to main content
Waffo 提供前端 SDK @waffo/payment-sdk,支持在商户页面内直接集成支付和绑卡功能。

安装

初始化

功能一览

绑卡(tokenizationSubmit)

商户前端将明文卡信息传给 SDK,SDK 在发送前加密卡片数据。在前端 SDK 绑卡模式下,只要商户后端不保留、不流转明文卡信息,商户就无需具备 PCI DSS 资质。

前置步骤

商户后端先调用 Generate API 获取 tokenSessionId

提交卡片

处理结果

如果 Generate 请求提供了 notifyUrl,Waffo 还会在绑卡完成、Token 状态变化或 Token 数据更新时发送 TOKENIZATION_NOTIFICATION。请以 result.tokenId 为幂等键更新本地 Token 数据。 完整流程参见 绑卡与 Token 管理

嵌入式收银台(renderIframe)

将 Waffo 收银台以 iframe 嵌入商户页面,适合不想自建收银台 UI 的商户。
支持:
  • 自定义主题颜色
  • 自定义 Logo
  • Apple Pay / Google Pay 按钮
  • 多语言

收银台外观定制

收银台的外观主题(cashierAppearance)、语言(cashierLanguage)与支付方式过滤,通过订单创建参数 paymentInfo 配置。完整的取值、格式与示例见 收银台客制化