一次看懂hyperswitch-prism支付方式：Card、Apple Pay、Google Pay、PayPal、Klarna全覆盖

【免费下载链接】hyperswitch-prismOne library | Many payment processors | Scale to multiple processors with few lines of code.项目地址https://gitcode.com/gh_mirrors/hy/hyperswitch-prism点击查看免费下载hyperswitch-prism 是一个面向多支付处理器的统一支付方式集成库用同一个authorize请求结构就能对接 Stripe、Adyen、PayPal、Klarna 等数十个 connector。Card 卡支付、Apple Pay 与 Google Pay 钱包、PayPal 跳转、Klarna 先买后付BNPL全部只需切换payment_method字段。本文带你一次看懂 hyperswitch-prism 支持的主流支付方式及其背后的关键概念。为什么需要统一的支付集成库每个支付处理器payment processor的 API、错误码、认证方式和文档行为都各不相同一处疏忽就可能造成真实资金损失。hyperswitch-prism 从生产级支付平台 Juspay Hyperswitch 中抽取而来把多年踩坑经验沉淀为一个轻量库核心优势有三点一个请求结构同一个authorize调用适用于 Stripe、Adyen 等众多处理器无需为每家重写逻辑无状态、零锁定无数据库、不存储 PII凭据只存在于 HTTP 客户端生命周期内降低 PCI 范围卡数据是否流经你的服务器完全由你决定更多背景可阅读项目根目录的 README.md。支付方式全景一张表看懂Prism 的authorize请求接受一个payment_method对象描述买家的支付工具。每个对象里只设置一个变体Prism 负责完成 connector 特定的转换。完整清单见 payment-methods/README.md类别payment_method字段典型场景 Card 卡card卡号直传需 PCI 合规 Connector Tokenconnector_token非 PCI 流程token 由处理器 JS SDK 生成钱包apple_pay/google_pay/paypal_redirectApple Pay、Google Pay、PayPal银行转账ach_bank_transfer/sepa_bank_transfer美国、欧元区转账直接借记ach/sepa/bacs银行代扣在线银行ideal/sofort/giropay欧洲网银跳转BNPL 先买后付klarna/afterpay_clearpay/affirm分期、先买后付UPIupi_collect/upi_intent/upi_qr印度 UPI 支付Card 卡支付最基础的请求结构Card 是最直接的支付方式商户直接收集卡号、有效期、CVC 并传给 Prism。一个典型的 Node.js 请求如下完整示例见 card.mdconst response await paymentClient.authorize({ merchantTransactionId: txn_001, amount: { minorAmount: 1000, currency: Currency.USD }, paymentMethod: { card: { cardNumber: { value: 4111111111111111 }, cardExpMonth: { value: 03 }, cardExpYear: { value: 2030 }, cardCvc: { value: 737 }, }, }, captureMethod: CaptureMethod.AUTOMATIC, });⚠️PCI 提示卡数据直传需要商户自行满足 PCI 合规。如果卡信息是通过 Stripe.js、Adyen Drop-in 等处理器 JS SDK 在浏览器端采集并 tokenize 的则应改用tokenAuthorize() 顶层connector_token字段原始卡数据完全不经过你的服务器。两种方式对比详见 connector-token.md。Apple Pay 集成加密 token 的两种解密路径Apple Pay 使用客户 Apple Wallet 中的 token 化卡片。流程是客户端通过 Apple Pay JS API或原生 SDK完成支付 sheet拿到PKPaymentToken对象再把其中的paymentDatabase64 加密数据、paymentMethod和transactionIdentifier原样传入payment_method.apple_pay——加密数据永远不需要手工构造。关键在于 token 的解密路径由商户 connector 账户配置决定详见 apple-pay.mdPSP 解密SkipDecryption加密 blob 封给处理器证书原样透传由处理器在授权时用 Apple 支付处理证书解密Hyperswitch 解密DecryptAtApplicationblob 封给 Hyperswitch 证书在授权前解密处理器收到的是 DPAN、有效期和在线支付密码cryptogramGoogle Pay 集成token 类型决定谁来解密Google Pay 与 Apple Pay 思路一致在浏览器中初始化 Google Pay API、调用loadPaymentData()取出paymentMethodData.tokenizationData.token传入payment_method.google_pay。区别在于tokenizationSpecification.type决定了 token 加密给谁详见 google-pay.mdPAYMENT_GATEWAYtoken 加密给处理器的网关密钥原样转发处理器自行解密——整个会话仅凭已存储的 connector 钱包配置拼装不额外调用 GoogleDIRECT/INTERNAL_GATEWAYtoken 加密给 Hyperswitch 控制的密钥授权前验证并解密CRYPTOGRAM_3DS得到带密码和 ECI 的 DPANPAN_ONLY得到真实卡 PANPayPal 钱包支付跳转认证只需一个 emailPayPal 是典型的跳转式钱包支付调用payment_method.paypal_redirect可带上客户 emailPrism 返回跳转地址客户到 PayPal 完成认证并批准付款随后被带回你的return_url。整个过程商户不接触任何卡信息请求结构非常简单见 paypal.md。Klarna 先买后付BNPL托管跳转流程Klarna 属于 Buy Now Pay Later先买后付客户选择分期或延后付款Klarna 负责信贷决策。Prism 通过return_url把客户重定向到 Klarna 的托管流程请求里甚至只需要一个空的payment_method.klarna对象偏好语言、账单信息等 connector 专属选项可经connectorFeatureData传入见 klarna.md。其他支付方式速览除上述五种主打方式外Prism 还覆盖在线银行跳转如 iDEAL荷兰客户在自家银行页面完成付款无需卡信息直接借记如 SEPA凭 IBAN 从欧元区银行账户代扣、ACH美国账户代扣券 / 现金、加密货币、礼品卡等完整字段清单见 payment-methods/README.md 换处理器不换请求无论底层是 Stripe 还是 AdyenCard、Apple Pay 等所有支付方式共用同一套请求结构只需切换 connector 配置这就是几行代码扩展新处理器的含义。快速上手三步发起第一笔支付安装 SDKNode.js 为例Python / Java / Rust 同理npm install hyperswitch-prism配置 connector以 Stripe 为例并创建PaymentClient调用authorize()按上文切换payment_method即可覆盖不同支付方式各语言 SDK 指南sdk/python、sdk/javascript、sdk/java、sdk/rust完整可运行的 Stripe Adyen 电商示例见 demo/e-commerce。完整文档与多语言示例在哪里找 支付方式文档docs/getting-started/payment-methods/ 全量 connector 能力矩阵docs/generated/connectors/ 与 all_connector.md 各 connector 的 TS / Python / Kotlin / Rust 示例examples/ API 服务参考docs/generated/api-reference/services/常见问题问卡数据会经过我的服务器吗答用card直传时会需 PCI 合规改用connector_token或钱包支付则不会库本身不存储、不记录任何卡数据。问Apple Pay / Google Pay 的 token 谁来解密答由payment_method对应的 connector 配置决定封给处理器的 token 原样透传、由 PSP 解密封给 Hyperswitch 的则先在授权前解密再下发。问接入多个处理器要重写多少代码答请求结构完全一致切换处理器只是换 connector 配置。业务路由、智能重试等编排逻辑属于上层平台Juspay Hyperswitch的范畴Prism 专注转换层。赞分享【免费下载链接】hyperswitch-prismOne library | Many payment processors | Scale to multiple processors with few lines of code.项目地址https://gitcode.com/gh_mirrors/hy/hyperswitch-prism点击查看免费下载相关推荐超简单Hyperswitch集成Apple Pay/Google Pay全指南超简单Hyperswitch集成Apple Pay/Google Pay全指南 你是否还在为支付方式集成繁琐而头疼顾客因支付步骤太多而流失本文将带你5分钟后端金融科技Apple Pay 与 Google Pay 工作原理移动支付令牌化架构深度解析Apple Pay 与 Google Pay 工作原理移动支付令牌化架构深度解析 这是一篇面向系统设计与支付领域的实战技术解读。本文以 how applego后端文档教程超简单Hyperswitch集成Amazon Pay支付方式的完整指南超简单Hyperswitch集成Amazon Pay支付方式的完整指南 Hyperswitch作为一款功能强大的支付编排平台让开发者能够轻松集成多种支付方式后端金融科技创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考