Enroll Payment 方式

本页面将指导您在客户账户中注册付款方式，并获取 vaulted_token 以备将来购买。

📘
拱顶Token
一旦注册了支付方式，就会创建一个VaultedToken ，并与客户信息一起存储。您可以在今后的支付中使用创建的 VaultedToken 来识别支付方式。

Yuno 的标记化服务和集中式保险库使您能够在不影响用户体验的情况下处理跨处理器的定期支付、回退和重试。以下支付方式可供注册 Yuno：

注册时可用的付款方式

付款方式	类型
卡片	`CARD`
努佩	`NU_PAY_ENROLLMENT`
贝宝	`PAYPAL_ENROLLMENT`
达维普拉塔	`DAVIPLATA_ENROLLMENT`
MercadoPago 钱包	`WALLET_CONNECT`
d 本地 Yape	`YAPE_ENROLLMENT`
dLocal 智能 PIX	`SMART_PIX`
Astropay	`ASTROPAY_ENROLLABLE`
内基*	`NEQUI`
哥伦比亚银行代币箱*	`BANCOLOMBIA_TOKENBOX`
阿迪恩 PIX 生物技术公司	`PIX_BIOMETRICO`

(*) 仅限 SDK。有关集成详情，请查阅SDK 文档。

要求

在开始注册程序之前，您需要

访问您的应用程序接口凭据在 Yuno Dashboard 上，它们由以下部分组成：
- public-api-key
- private-secret-key
- account_id
在 Yuno Dashboard 账户上设置连接。添加需要注册的付款方式。
为付款方式建立路由，以定义处理方式。
配置结账生成器，使您的连接支付可用。

步骤摘要

在客户账户中注册付款方式的步骤如下。

创建客户
创建客户会话（结账工作流程专用）
(可选）检索可供注册的付款方式 -结账工作流程
注册付款方式结账工作流程/直接工作流程
检索付款方式 -直接工作流程

注册付款方式

步骤 1：创建客户

使用创建客户注册客户信息。您需要提供个人客户信息。此外，您还需要提供 merchant_customer_id客户的唯一标识符。

📘
客户补充信息
创建客户时，某些信息不是必须提供的，但提供这些信息可以改善用户的支付体验。电话、账单地址和送货地址就是可以提供的非必填数据。如果添加可选信息，请注意必填字段。

在创建客户流程结束时，您将收到一份 id该用户在 Yuno 系统中的身份标识。如果您要为现有用户注册付款方式，该用户之前已创建并拥有一个 id您可以跳过这一步。

步骤 2：创建客户会话

🚧
工作流程要求
注册工作流程因付款方式类型而异：

结账工作流程：大多数付款方式（卡、Nupay、PayPal、Daviplata、dLocal 方法、Astropay、Adyen PIX Biométrico）都需要客户会话。

直接工作流程:仅适用于信用卡（符合 PCI 标准的商家）。使用客户信息直接进入步骤 3 id 在步骤 1 中生成。

SDK 工作流程：Nequi 和 Bancolombia Tokenbox 等付款方式需要 SDK 实施。WALLET_CONNECT (MercadoPago) 同时支持 SDK 和结账工作流程。详情请查阅SDK 文档。

Seamless SDK您可以在无缝支付流程中设置支付方式进行注册。 vault_on_success: true 在创建付款时。若付款成功，该付款方式将自动注册。详见 Seamless SDK （网络支付）了解更多详情。

创建客户后，您将创建一个客户会话，以识别和存储客户的付款偏好信息。使用endpoint 创建客户会话来执行请求。请注意 customer_id 执行请求所需的 id 中创建客户时收到的步骤 1.

来自endpoint响应创建客户会话您将收到 customer_session.它将在付款方式注册过程中使用。

步骤 3：检索付款方式进行注册

这是一个可选步骤，您可以列出客户可以注册的所有可用付款方式。如果您知道用户将选择哪种付款方式，就可以进入第 4 步。

要列出可用的付款方式，可以使用 "检索要注册的付款方式 "endpoint。如果使用结账工作流程您将通知 customer_session 在请求上。直接工作流程目前不支持检索可用的付款方式进行注册。

对endpoint的响应 检索Payment 方式进行Enroll 将只包含 payment_methods 参数。它将提供一个对象数组，包含所有可供注册的付款方式。您将使用 type 信息，以便在下一步注册付款方式。

📘
可用付款方式
当您检索可供注册的付款方式时，只有您已连接、创建路由并添加到结账中的付款方式才会出现在响应中。

步骤 4：注册付款方式

定义付款方式后，可使用其中一个 "注册付款方式 "endpoints执行注册：

结账工作流程:提供 type 与所选支付方式相关的参数 payment_method_type.支持的类型包括 CARD, NU_PAY_ENROLLMENT, PAYPAL_ENROLLMENT, DAVIPLATA_ENROLLMENT, WALLET_CONNECT, YAPE_ENROLLMENT, SMART_PIX, ASTROPAY_ENROLLABLE (有空格）、 PIX_BIOMETRICO.
直接工作流程:提供 type 与所选支付方式相关的参数 type.(仅适用于 CARD 为符合 PCI 标准的商家提供支付方法）
SDK 工作流程:付款方式，如 NEQUI 和 BANCOLOMBIA_TOKENBOX 需要执行 SDK。 WALLET_CONNECT (MercadoPago）同时支持 SDK 和结账工作流程。

用户必须重定向到付款提供商页面才能完成注册过程。您将在步骤 5 中收到该 URL。

步骤 5：检索付款方式

要成功注册付款方式，客户必须在付款提供商页面上提供授权。要接收 URL，请根据您使用的工作流程使用以下endpoints 之一：

结账工作流程：注册 URL 直接在步骤 4 的注册响应中提供。参数 provider.redirect.init_url.
直接工作流程：对于直接工作流程，由于它仅适用于贺卡注册，您将在上一步中收到最终状态。

重定向用户，让他们提供所需的授权。注册完成后，下一步就可以创建结账会话了。

要确认注册，可以检索已注册的付款方式。付款方式 status 注册付款方式的 ENROLLED.

📘
Fingerprint
注册信用卡时，您还会发现 fingerprint 在 API 响应中。它是一个字段，代表客户的信用卡在整个组织中的信息。当客户多次注册与一个或多个 Yuno 账户相关的信用卡时，就会生成多个 vaulted_tokens，但fingerprint 可让您识别同一张卡在多个场景中的使用情况。
当使用注册的信用卡进行交易时，您还会在支付响应中发现fingerprint 。