Network token 管理

您可以使用此功能来配置网络令牌、获取网络令牌的密码以进行付款、删除网络令牌并接收令牌状态更新通知。

获取 network token

1. 使用 POST 方法调用 paymentMethod 接口时需要包含但不限于以下参数，字段详情参考 API 文档：
2. networkTokenOnly: Fixed value: true。
   • paymentMethod.type: 固定值 card。
   • paymentMethod.card: 包含消费者卡信息的结构体。当 paymentMethod.type 为 card 时必填。
   • paymentMethod.card.cardSource: 支付工具（PAN）的来源。
   • userInfo.email: 用户的电子邮件地址，不超过 48 个字符。
   • userInfo.locale: 用户的语言和位置，例如：zh_HK。
3. 您将收到 paymentMethod 响应，其中包含：
   • paymentMethod.status: 请求状态，枚举值 Success 或 Failed。
   • merchantTransID: 与原 paymentMethod 请求关联的商家交易订单号。
   • paymentMethod.networkToken: 该结构题包含 network token 的信息，具体请参见 API 规范。

获取 network token 的一次性密码

1. 使用 POST 方法调用 cryptogram 接口时需要包含但不限于以下参数，字段详情参考 API 文档：
   • paymentMethod.type: 固定值 networkToken .
   • paymentMethod.networkToken.tokenID: 此字段用于发送在 paymentMethod 接口中获取的网络令牌时获得的 network token ID。
2. 您将收到 cryptogram 响应，其中包含：
   • cryptogram.status: 请求状态，枚举值 Success 或 Failed。
   • cryptogram.merchantTransID: 与原 cryptogram 请求关联的商家交易订单号。
   • paymentMethod.networkToken: 该结构题包含 network token 的信息，其中也包含了 neywork token 的一次性密码，具体请参见 API 规范。

查询 network token 的获取结果

1. 如果您没有收到我们 paymentMethod 接口的应答，您可以使用 GET 的方式调用paymentMethod 接口来查询获取 network token 的结果，您需要在请求中上送以下字段：
   • merchantTransID: 在请求 endpoint 中的值。原 paymentMethod 请求的商户订单号。

查询一次性密码的获取结果

1. 如果您没有收到我们 cryptogram 接口的应答，您可以使用 GET 的方式调用cryptogram 接口来查询一次性密码的获取结果，您需要在请求中上送以下字段：
   • merchantTransID: 在请求 endpoint 中的值。原 cryptogram 请求的商户订单号。

删除 network token

1. 使用 DELETE 的方式调用paymentMethod 接口，您需要在请求中上送以下字段：

   • networkTokenID (请求参数): 此字段用于发送在 paymentMethod 接口中获取的网络令牌时获得的 network token ID。

2. 您将收到 paymentMethod 响应，其中包含：

   • result.code: 请求结果，枚举值 Success 或 Failed。
   • paymentMethod.networkToken: 该结构题包含 network token 的信息，具体请参见 API 规范。
   • paymentMethod.networkToken.status: Network token 的状态，如果状态为 INACTIVE 表示 network token 已被删除。

Network token 状态更新通知

TIP

当 network token 状态更新，我们将向您发送以下通知：

• eventCode: tokenUpdate
• paymentMethod.networkToken: 该结构题包含 network token 的信息，具体请参见 API 规范。

TIP

当获取 network token 成功，我们将向您发送以下通知：

• eventCode: paymentMethod
• merchantTransID: 与原 paymentMethod 请求关联的商家交易订单号。
• paymentMethod.networkToken: 该结构题包含 network token 的信息，具体请参见 API 规范。
• paymentMethod.status: network token 的获取状态，枚举值 `Success。

获取一次性密码的通知

1. 当一次性密码获取成功，我们将向您发送以下通知：
   • eventCode: Cryptogram
   • cryptogram.networkToken: 该结构题包含 network token 的信息，其中也包含了 neywork token 的一次性密码，具体请参见 API 规范。