Network token 管理

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

获取 network token

使用 POST 方法调用 paymentMethod 接口时需要包含但不限于以下参数，字段详情参考 API 文档：

networkTokenOnly: Fixed value: true。

paymentMethod.type: 固定值 card。

paymentMethod.card: 包含消费者卡信息的结构体。当 paymentMethod.type 为 card 时必填。

paymentMethod.card.cardSource: 支付工具（PAN）的来源。

userInfo.email: 用户的电子邮件地址，不超过48个字符。

userInfo.locale: 用户的语言和位置，例如：zh_HK。

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

paymentMethod.status: 请求状态，枚举值 Success 或 Failed。

merchantTransID: 与原 paymentMethod 请求关联的商家交易订单号。

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

获取 network token 的一次性密码

使用 POST 方法调用 cryptogram 接口时需要包含但不限于以下参数，字段详情参考 API 文档：

paymentMethod.type: 固定值 networkToken .

paymentMethod.networkToken.tokenID: 此字段用于发送在 paymentMethod 接口中获取的网络令牌时获得的 network token ID。

您将收到 cryptogram 响应，其中包含：

cryptogram.status: 请求状态，枚举值 Success 或 Failed。

cryptogram.merchantTransID: 与原 cryptogram 请求关联的商家交易订单号。

paymentMethod.networkToken: 该结构题包含 network token 的信息，其中也包含了 neywork token 的一次性密码，具体请参见API规范。

查询 network token 的获取结果

如果您没有收到我们 paymentMethod 接口的应答，您可以使用 GET 的方式调用paymentMethod 接口来查询获取 network token 的结果，您需要在请求中上送以下字段：

merchantTransID: 在请求 endpoint 中的值。原 paymentMethod 请求的商户订单号。

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

如果您没有收到我们 cryptogram 接口的应答，您可以使用 GET 的方式调用cryptogram 接口来查询一次性密码的获取结果，您需要在请求中上送以下字段：

merchantTransID: 在请求 endpoint 中的值。原 cryptogram 请求的商户订单号。

删除 network token

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

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

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

result.code: 请求结果，枚举值 Success 或 Failed。

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

paymentMethod.networkToken.status: Network token 的状态，如果状态为 INACTIVE 表示 network token 已被删除。

Network token 状态更新通知

提示

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

eventCode: tokenUpdate

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

提示

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

eventCode: paymentMethod

merchantTransID: 与原 paymentMethod 请求关联的商家交易订单号。

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

paymentMethod.status: network token 的获取状态，枚举值 `Success。

获取一次性密码的通知

当一次性密码获取成功，我们将向您发送以下通知：

eventCode: Cryptogram

cryptogram.networkToken: 该结构题包含 network token 的信息，其中也包含了 neywork token 的一次性密码，具体请参见API规范。

获取 network token#

获取 network token 的一次性密码#

查询 network token 的获取结果#

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

删除 network token#

Network token 状态更新通知#

获取一次性密码的通知#

获取 network token

获取 network token 的一次性密码

查询 network token 的获取结果

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

删除 network token

Network token 状态更新通知

获取一次性密码的通知