Payment 状态

要监控付款,您可以使用 Yuno 提供的监控状态解决方案之一。您可以使用以下两个选项之一:

  • 状态:您可以使用状态 SDK 向用户更新付款流程。它可为客户提供可视化信息。
  • Status Lite:您可以使用 StatusLite SDK 获取有关当前付款状态的信息。不过,Status Lite 不安装任何元素。

两种解决方案的initialize 方式相同。在系统中添加 Yuno SDK 并创建实例后,请参阅所需的状态解决方案,了解如何使用它。

第 1 步:在项目中加入程序库。

确保 Yuno SDK 文件包含在网页中,然后关闭 <body> 标签。请看下面的示例:

<script src="https://sdk-web.y.uno/v1.5/main.js"></script>

步骤 2:使用公钥Initialize SDK

在您的 JavaScript 应用程序中,创建一个 Yuno 类提供一个有效的 PUBLIC_API_KEY.参见 获取应用程序接口证书 指导。

像下面的例子一样,使用归属于 yuno 不变:

<script src="https://sdk-web.y.uno/v1.5/main.js"></script>

创建实例后,可选择使用 "状态 "或 "状态精简版 "解决方案来访问付款状态。

步骤 3:使用状态

要使用 "状态",您需要安装它。使用 mountStatusPayment 函数来定义 checkoutSession 与付款有关的 countryCode,"...... language和回调 yunoPaymentResult.

当收到状态信息时,将执行回调,通知用户。无需定义挂载状态的元素,因为它将覆盖整个屏幕。下面的代码块显示了参数配置的示例:

yuno.mountStatusPayment({
  checkoutSession: '438413b7-4921-41e4-b8f3-28a5a0141638',
  countryCode: 'FR',
  language: 'fr',
  yunoPaymentResult(data) {
    console.log('yunoPaymentResult', data)
  }
})

参数

参数说明
checkoutSession您要监控的付款的结账会话 ID
countryCode付款流程的国家代码。有关支持的国家,请参阅国家覆盖范围
language状态显示语言。支持的选项:En、FR、JP
yunoPaymentResult接收付款状态的回调函数。数据参数可以是READY_TO_PAY"、CREATED"、SUCCEEDED"、SUCCEEDEDDECLINED"、SUCCEEDEDCANCELLED"、EXPIREDREFUNDEDEXPIRED"、EXPIREDREFUNDEDDECLINED"、PENDING"、EXPIRED"、VERIFIED"、REFUNDED"。

使用状态精简版

要使用 Status Lite 接收当前付款状态,需要调用方法 yunoPaymentResult 提供 checkoutSession 与付款有关,如下例所示:

const status = await yunoyunoPaymentResultcheckoutSession)

"(《世界人权宣言》) yunoPaymentResult 方法返回当前付款状态,而不会呈现任何用户界面元素。返回的状态可以是以下值之一:

  • READY_TO_PAY
  • CREATED
  • SUCCEEDED
  • REJECTED
  • CANCELLED
  • ERROR
  • DECLINED
  • PENDING
  • EXPIRED
  • VERIFIED
  • REFUNDED
👍

自定义付款状态集成

如果您想使用自己的自定义付款状态页面,而不是对我们的 SDK 提供的页面进行个性化设置,您可以通过编辑 HTML 文件连接到已编辑的 status-lite.js 脚本。这样,您就可以完全自定义付款状态显示的外观和行为,同时仍可使用 Yuno 的状态功能。例如,在调用 yunoPaymentResult 函数中处理状态结果。 status-lite.js 脚本,然后更新您的自定义 HTML 文件。

保持更新

请访问更新日志,了解最新的 SDK 更新和版本历史。