Network Token update notification
网络令牌的状态可能会被发卡行修改。网络令牌状态发生变更时,EVO Payment 会向商户的 webhook 发送通知。这个 webhook 是创建网关令牌时,在 POST Payment 或 POST PaymentMethod 请求中设置的地址。
以下场景中,EVO Payment 会向该 webhook 发送通知:
| 场景 | 通知中的 eventCode |
|---|---|
| 网络令牌已删除 | NetworkTokenDeleted |
| 网络令牌已更新 | NetworkTokenStatusUpdated |
网络令牌已删除
持卡人可能会在发卡行一侧删除自己的网络令牌。此时 EVO 会通过异步通知告知商户,通知中包含以下字段:
- eventCode:固定值 NetworkTokenDeleted。
- paymentMethod.networkToken.status:网络令牌状态。网络令牌已删除时,值为 disable。
- paymentMethod.token.status:网关令牌状态,值为 enabled。
- paymentMethod.networkToken.tokenID:卡组织分配的网络令牌唯一 ID。
- paymentMethod.token.value:EVO Payment 生成的网关令牌值。
INFO
网络令牌被删除后,网关令牌仍然可以正常用于支付。
网络令牌已更新
发卡行有时会更新网络令牌的信息,例如更新有效期、暂停网络令牌。此时 EVO 会通过异步通知告知商户,通知中包含以下字段:
- eventCode:固定值 NetworkTokenStatusUpdated。
- paymentMethod.networkToken.status:网络令牌状态。网络令牌被暂停时,值为 supended;其他情况下,值为 enable。
- paymentMethod.networkToken.expiryDate:网络令牌有效期。
- paymentMethod.networkToken.first6No:网络令牌前 6 位。
- paymentMethod.networkToken.last4No:网络令牌后 4 位。
- paymentMethod.token.status:网关令牌状态,值为 enabled。
- paymentMethod.networkToken.tokenID:卡组织分配的网络令牌唯一 ID。
- paymentMethod.token.value:EVO Payment 生成的网关令牌值。

