了解如何在网站或应用程序中嵌入自定义 WooshPay 支付表单。客户端和服务器端代码会创建一个结账表单,其中包含使用各种支付方式完成支付的元素。
付款流程 #
使用 WooshPay SDK 有几个步骤:
创建 PaymentIntent #
在服务器上添加一个创建 PaymentIntent 的端点。PaymentIntent 会跟踪客户的付款周期,记录任何失败的付款尝试,确保客户只被收取一次费用。在响应中返回 PaymentIntent 的客户端秘密(本例中为 PaymentIntent 编号),以完成客户端支付。我们默认为您启用银行卡。
加载 wooshpay.js #
使用 wooshpay.js,确保支付信息直接发送到 WooshPay 而不影响您的服务器,从而符合 PCI 标准。请始终从 js.wooshpay.com 加载 wooshpay.js 以保持合规。请勿将脚本包含在捆绑包中或自行托管。
初始化 WooshPay 元件 #
使用客户秘密初始化 WooshPay Elements UI 库。Elements 管理着收集支付信息所需的用户界面组件。
完成客户付款 #
完成付款
致电 确认付款()
,同时传递 PaymentElement 和 return_url,以指明用户完成支付后 WooshPay 应将其重定向到哪里。对于需要身份验证的支付,WooshPay 会显示 3D 安全身份验证的模态,或根据支付方法将客户重定向到身份验证页面。客户完成验证过程后,他们将被重定向到 return_url
.
处理错误 #
如果出现任何即时错误(例如,客户的银行卡被拒),wooshpay.js 将返回错误信息。向客户显示错误信息,以便他们可以重试。
显示付款状态信息 #
当 WooshPay 将客户重定向到 return_url
,"...... 付款意向客户保密信息
查询参数由 wooshpay.js 添加。用它来检索 PaymentIntent,以确定向客户显示什么内容。
获取演示 #
您可从此处下载 JS SDK 演示下载