跳转到内容

Network Token update notification ​

网络令牌的状态可能会被发卡行修改。网络令牌状态发生变更时,EVO Payment 会向商户的 webhook 发送通知。这个 webhook 是创建网关令牌时,在 POST Payment 或 POST PaymentMethod 请求中设置的地址。

以下场景中,EVO Payment 会向该 webhook 发送通知:

场景通知中的 eventCode
网络令牌已删除NetworkTokenDeleted
网络令牌已更新NetworkTokenStatusUpdated

网络令牌已删除 ​

持卡人可能会在发卡行一侧删除自己的网络令牌。此时 EVO 会通过异步通知告知商户,通知中包含以下字段:

  1. eventCode:固定值 NetworkTokenDeleted。
  2. paymentMethod.networkToken.status:网络令牌状态。网络令牌已删除时,值为 disable。
  3. paymentMethod.token.status:网关令牌状态,值为 enabled。
  4. paymentMethod.networkToken.tokenID:卡组织分配的网络令牌唯一 ID。
  5. paymentMethod.token.value:EVO Payment 生成的网关令牌值。

INFO

网络令牌被删除后,网关令牌仍然可以正常用于支付。

网络令牌已更新 ​

发卡行有时会更新网络令牌的信息,例如更新有效期、暂停网络令牌。此时 EVO 会通过异步通知告知商户,通知中包含以下字段:

  1. eventCode:固定值 NetworkTokenStatusUpdated。
  2. paymentMethod.networkToken.status:网络令牌状态。网络令牌被暂停时,值为 supended;其他情况下,值为 enable。
  3. paymentMethod.networkToken.expiryDate:网络令牌有效期。
  4. paymentMethod.networkToken.first6No:网络令牌前 6 位。
  5. paymentMethod.networkToken.last4No:网络令牌后 4 位。
  6. paymentMethod.token.status:网关令牌状态,值为 enabled。
  7. paymentMethod.networkToken.tokenID:卡组织分配的网络令牌唯一 ID。
  8. paymentMethod.token.value:EVO Payment 生成的网关令牌值。