将Yuno配置为提供商

要使用 Yuno 作为提供商向客户提供更多付款方式，您需要按照以下步骤将您的 VTEX 账户连接到 Yuno 并配置您要提供的付款方式。

1. 登录您的VTEX 商店账户。

2. 在 VTEX Admin 面板中，导航至 "商店设置">"提供商"，然后单击 "新建提供商"。

3. 在对话框中搜索Yuno，然后在结果中选择Yuno选项。

4. 在表格中填写所需信息。以下是每个需要填写的字段的说明：

📘

特许经营账户字段

只有当您的 VTEX 环境使用特许经营模式时，才填写 "主帐户... "字段。对于标准账户或卖方门户账户，请留空。

🚧

测试模式警告

VTEX 建议您不要在生产环境中启用测试模式，因为测试付款选项将提供给商店中的客户。

❗️

自动结算警告

有一个已知问题会影响 "计划"选项：调度自动捕捉。详情请点击此处。

在执行更新之前 (PUT)，隶属关系首先会对 GET 请求来检索当前配置。

5. 填写完所有字段后，点击保存。
6. 导航至 "商店设置" > "设置"，然后单击+按钮（右上角的绿色按钮）添加新的付款选项。

7. 选择您希望为客户提供支付方式。您需要为每种可用的支付方式配置服务商，包括卡品牌（Visa、万事达卡等）、替代支付方式（PIX、Boleto、Mercado Pago钱包等）及其他支付类型。

8. 选择付款方式后，将显示一个新对话框，您需要在其中配置付款提供商：
   1. 在 "与提供商一起处理"中，选择Yuno。
   2. 必要时添加特殊条件。有关配置特殊条件的其他信息，请访问配置付款特殊条件。有关考虑分期付款（带息或不带息）的付款条件配置的更多信息，请查看VTEX 页面。
   3. 单击保存。
   4. 将状态更改为激活。

📘

添加多种付款方式

若需为客户提供多种支付方式，请针对每种支付方式重复步骤7和8。例如：

• 要支持Visa和Mastercard，请重复步骤7和8两次，一次用于Visa，另一次用于Mastercard。
• 若要提供银行卡及替代支付方式（如Mercado Pago电子钱包或PIX），请分别配置每种支付方式。

9. 最后一步是配置 Webhook URL，以便从付款中接收更新。
   1. 访问Yuno 控制面板并选择开发人员。
   2. 选择Webhooks选项卡。
   3. 点击 添加网络钩子.网络钩子表单将显示出来，您应在其中提供以下信息：
      1. 名称：定义 VTEX 网络钩子的名称。
      2. Endpoint URL:您应告知以下 URL https://{store_name}.myvtex.com/_v/yunopartnerbr.yuno/v4/webhook （替换 {store_name} 用您的实际商店名称）。
      3. x-api-key和x- secret：您可以在此设置任何信息。例如，可以为这两个字段添加VTEX。
   4. 对于 "触发"，请选中所有应通过 webhooks 通知您的事件。Yuno 建议选中所有选项。
   5. 单击添加。

PIX 支付过期管理

在使用 VTEX 配置 PIX 付款时，Yuno 提供自动过期处理功能，以防止出现订单对账问题：

• 自定义过期跟踪（连接级）： Yuno 根据以下信息监控 PIX 支付到期情况 expiration_date 在 VTEX-Yuno 连接中定义，而无需完全依赖提供商网络钩子
• 主动验证：在过期之前，Yuno 会请求提供商确认付款是否已完成
• 自动取消订单：如果 PIX QR 码过期未支付，Yuno 会将付款标记为过期，并立即通过 webhook 通知 VTEX，以便自动取消订单。
• 对账一致性：这可确保 VTEX、Yuno 和支付提供商之间的支付状态保持同步

该功能对于防止 VTEX 继续重试已过期的 PIX 付款、消除状态不匹配和减少对账开销特别有用。

📘

重要

对于 VTEX 集成 expiration_date 配置在 连接级别 中的过期时间。这种增强的过期处理仅适用于在连接中设置自定义过期时间的情况，而不适用于使用默认提供程序过期的情况。

完成上述步骤后，您的客户就可以在结账时使用新的付款方式。 例如，如果您配置了 Visa，当客户在结账时选择信用卡时，Yuno 结账会在后台收集欺诈筛查和 3DS 服务所需的所有信息，同时使用 VTEX 信用卡表单。

一旦您开始使用 Yuno 在 VTEX 中接收付款，您就可以在Yuno 面板上看到与交易相关的所有信息，就像正常付款一样。

• 作为付款详情中的附加信息，特别是元数据结构中的附加信息，您还可以识别与创建付款相关的 VTEX 账户。

  JSON

  "metadata": [
      {
        "key": "vtex_account",
        "value": "[your_vtex_subaccount]"
      }
    ]

• 当客户尝试多次付款且这些付款均被拒绝时，VTEX将激活 防御模式在此期间，VTEX不会执行我们的支付应用程序，这意味着Yuno的欺诈检测功能将被禁用。支付流程将由VTEX延迟处理，并转发至Yuno PPF连接器。一旦接收到支付请求，Yuno PPF连接器将随元数据一同发送支付信息。 defense_mode=true.

  Yuno建议配置一条绕过欺诈验证的路由，每当 defense_mode 元数据被设置为 true.

  JSON

  "metadata": [
    {
      "key": "defense_mode",
      "value": "[true/false]"
    }
  ]

• VTEX连接器捕获了 sellerId (联盟代码) 来自 VTEX 订单，并将其包含在结账会话和支付元数据中。这启用了市场追踪和联盟模式功能，使商家能够追踪其自有商店与合作伙伴市场之间的归因关系。

  JSON

  "metadata": [
    {
      "key": "sellerId",
      "value": "[affiliate_code_from_vtex_order]"
    }
  ]

  有关VTEX联盟模式的更多信息，请参阅VTEX文档中关于配置联盟的说明。

点击支付的自动客户创建

当客户在VTEX商家处选择通过Click to Pay支付时，VTEX连接器会在结账流程初始化阶段自动在Yuno中创建对应的VTEX客户记录。此举通过消除冗余数据录入，确保支付流程顺畅无阻。

工作原理：

• 自动创建：当购物者发起点击支付交易时，若VTEX客户尚未存在于Yuno系统中，则会自动创建。
• 数据映射：VTEX个人资料中所有客户数据将自动映射至Yuno，并纳入结账流程。
• 预填字段：SDK会自动从VTEX个人资料中预填客户信息（CVV、email、地址），客户无需重复输入这些信息。
• 用户体验优化：点击支付流程与非VTEX商户的精简体验保持一致，无冗余输入步骤

此功能需要在VTEX供应商配置中将"创建客户"字段设置为"是"（参见上述配置流程中的第4步）。

📘

重要

自动创建客户功能仅适用于选择"点击支付"作为支付方式的情况。对于其他支付方式，客户创建将遵循基于"创建客户"配置设置的标准流程。

定制

如果您想添加或更改结账的某些用户体验方面，VTEX 允许商家修改一些内容：

• 结账页面定制
• 在结账中更改付款方式名称。

可用选项

有关自定义自动捕捉功能的更多信息，请参阅 VTEX 文档。

ClearSale 字段映射

当使用ClearSale欺诈检测与VTEX连接器时，Yuno会自动将VTEX订单数据映射至ClearSale所需字段。这确保所有必要信息均能准确传递至ClearSale进行欺诈分析。

配送类型映射

"(《世界人权宣言》) deliveryType VTEX订单中的该字段将自动提取并映射至ClearSale系统。对于使用ClearSale拒付保障产品的商家，此字段为必填项。

VTEX到ClearSale映射：

VTEX连接器提取 deliveryType VTEX订单日志中的数据（可在 AdditionalData.Order.Shipping.Type并正确将其映射到ClearSale。常见的配送类型值包括：

• Normal → 映射为 NORMAL
• ECONOMY → 映射为 ECONOMY
• 其他配送类型根据ClearSale的字段要求进行映射

配送类型将自动包含在发送至ClearSale的有效负载中，确保符合ClearSale针对拒付保障产品的必填字段要求。

📘

ClearSale 集成

对于使用ClearSale拒付保障产品的商户， deliveryType 该字段为必填项。VTEX连接器确保该字段能从VTEX订单中正确提取，并按ClearSale要求进行规范格式化。