网络Tokens

网络tokens 是支付处理行业的一大进步，是敏感支付卡信息（包括信用卡号）的数字代理。这些tokens 由威士卡、万事达卡和美国运通卡等支付网络发行，是在不断发展的数字环境中提高交易安全性的最前沿。

网络tokens的优势

增强安全性：网络tokens 在交易过程中取代了实际的银行卡数据，在加强安全措施方面发挥了重要作用，大大降低了潜在欺诈的风险。
无缝集成：我们的解决方案符合 EMVCo 的网络token 标准，只需极少的集成工作，就能确保无缝、高效的实施过程，从而快速适应各种支付场景。
自动更新：网络tokens由银行卡网络自动管理和更新，有助于减少购物摩擦和拒绝付款的情况。与没有网络tokens的交易相比，这种固有的适应性可确保更高的授权率。

一次性使用token 与保险库token 与网络token

一次性使用token	拱顶token	网络token
使用 Yuno 的 SDK 时，我们会收集处理付款所需的所有信息，并将其存储在一次性使用的token中，无论客户选择哪种付款方式。您将在创建付款时使用该token 。请注意，该token 只能使用一次。您需要为创建的每个结账会话生成一个新的一次性token 。	注册付款方式后，Yuno 会创建一个保险库token ，并与客户信息一起存储。您可以在今后的付款中使用创建的保险库token 来识别付款方式。	由维萨卡、万事达卡或美国运通卡等主要支付网络发行的敏感支付卡信息（如信用卡号）的数字化表示。这些tokens 的作用是在交易中替代实际的银行卡数据，从而通过最大限度地减少潜在欺诈活动的风险来提高安全性。

启用网络tokens 功能后，Yuno 会为所有注册的卡生成网络tokens ，并安全地存储在我们的保管库中。这种方法完全符合维萨卡和万事达卡在卡片验证后定义的网络令牌化工作方式，可确保在经常性交易和未来交易中实现更好的性能、安全性和可靠性。未存储在 Yuno 中的卡，如一次性使用卡，自然不包括在此过程中，因为网络标记化不适用于这些情况。

网络tokens 生命周期

网络tokens 可具有下文所述的状态。

现状	说明
创建	已创建的网络token 的初始状态。
活跃	网络token 处于激活状态，可用来付款。
暂停	如果持卡人与发卡机构联系，要求阻止来自特定商家的付款，Tokens 可能会被暂停。
已取消	Tokens 可能会因各种原因被注销，例如与token 相关的持卡人账户被关闭。

整合类型

要使用网络tokens付款，您有两种选择：

让 Yuno 提供和收集网络tokens。
使用现有的网络tokens。

1.让 Yuno 提供和收集网络tokens

我们从 Visa、Mastercard 和 American Express 等主要银行卡网络采购网络tokens 。这些tokens 安全地存储在 Yuno 基础设施中，在授权过程中代替实际卡片使用。

当 Yuno 代表您管理代币的募集和积累时，无需额外的集成即可获得网络tokens 化的好处。只需遵循与您的特定银行卡支付集成相对应的标准支付工作流程即可。Yuno 无缝处理该流程，用网络token替代银行卡详细信息，从而提高授权率。

要使用网络tokens激活支付，请联系我们的支持团队提供或申请必要的凭证。

响应示例

在注册或创建付款时，您都会收到相应操作中使用的网络token 的基本信息。

{
    "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "DE",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "EUR",
        "value": 5000
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "vaulted_token": "61d49d6e-7c0e-49d0-be79-7eb08871f998",
        "detail": {
           "card": {
               "network_token":{
                  "network":"MASTERCARD",
                  "status": "ACTIVE",
                  "par":"V0010014622074319305424002620",
                  "token_data":{
                    "iin":"45079900",
                    "lfd": "0010",
                    "expiration_month":"10",
                    "expiration_year":"2028",
                    "response":{
                      "code":"succeeded",
                      "message": "Transaction Succeeded"
                    }
                  }
              }
           }
        }
    }
  [...]
}

2- 使用现有网络tokens

在 Yuno 账户中设置必要的凭证并联系我们的支持团队后，您就可以无缝执行标记化交易了。

❗️
使用该选项时，Yuno 只充当网络token 信息的传递者。商家必须提供必要的网络tokens 信息，这样 Yuno 才能与上游支付合作伙伴共享这些信息。

网络token 交易利用现有的支付交易 API 请求。与使用信用卡详细信息创建付款类似，当商家使用 Yuno API 完成付款时，他们可以选择包含 "network_token "对象，以便在交易中使用网络token 。

付款申请字段

与 card_data 对象，这些字段应添加到 payment_method.detail.card.network_token.token_data 对象，用于使用 Yuno 的 API 发送付款。

现场	类型	说明
`number`	编号	[必填] -Token编号，不含任何分隔符。(最多 19 个；最少 8 个）- 仅适用于 PCI 认证商家
`holder_name`	字符串	持卡人在token 上的全名（最多 26 个；最少 3 个）--仅适用于 PCI 认证商家
`expiration_month`	整数	[必填] -Token的到期月份 - MM（最多 2 个；最少 2 个）- 仅适用于 PCI 认证的商家
`expiration_year`	整数	[必填] -Token的有效年份 - YYYY（最多 4 个；最少 4 个）- 仅适用于 PCI 认证的商家
`cryptogram`	字符串	[必填] - 发卡机构为交易中使用的网络token 生成的唯一密码。经常性交易可选
`electronic_commerce_indicator`	字符串	[仅某些提供商需要] - 如果token 已通过万事达卡验证，该字段应设置为 02。对于 Visa 或未经验证的tokens，则无需发送该字段。
`token_requestor_id`	字符串	[商户的Token 申请者 ID

Request 示例

{
  "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "DE",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "EUR",
        "value": 5000
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "detail": {
           "card": {
             "card_data": {
                "number": "4000000000001026",
                "holder_name": "John Doe",
                "expiration_month": 1,
                "expiration_year": 26,
                "security_code": "123"
              },
             "network_token":{
                  "token_data":{
                    "number":"4000000000001026",
                    "holder_name":"Jhohn Doe",
                    "expiration_month":1,
                    "expiration_year":26,
                    "cryptogram":"CCADBxYzRTBBXXXXXXXYZa0AbZD"
                  }
              }
           }
        }
    }
  [...]
}

响应示例

{
    "description": "Test",
    "account_id": "{{account-code}}",
    "merchant_order_id": "0000023",
    "country": "DE",
    "merchant_reference" : "reference-{{$randomUUID}}",
    "amount": {
        "currency": "EUR",
        "value": 5000
    },
    "customer_payer": {
        "id":"967ecd18-d898-4b88-9400-dd5b01b18edc"
    },
    "workflow": "DIRECT",
    "payment_method": {
        "type":"CARD",
        "detail": {
           "card": {
              "card_data": {
                        "holder_name": "John Doe",
                        "iin": "48710499",
                        "lfd": "9910",
                        "number_length": 16,
                        "security_code_length": 3,
                        "brand": "VISABANCONTACT",
                        "issuer_name": "BNP PARIBAS FORTIS NVSA",
                        "issuer_code": null,
                        "country_code": "BE",
                        "category": "CLASSIC",
                        "type": "DEBIT",
                        "expiration_month": 3,
                        "expiration_year": 30,
                        "fingerprint": "4d486017-afa0-4f2c-ba51-a09af528bd38"
                        [...]
                    }, 
              "network_token":{
                  "network":"MASTERCARD",
                  "status": "ACTIVE",
                  "par":"V0010014622074319305424002620",
                  "token_data":{
                    "iin":"45079900",
                    "lfd": "0010",
                    "holder_name":"Jhohn Doe",
                    "expiration_month":10,
                    "expiration_year":28,
                    "response":{
                      "code":"succeeded",
                      "message": "Transaction Succeeded"
                    }
                  }
              }
           }
        }
    }
  [...]
}