跳转到内容

Network Token update notification

Due to the fact that the status of the network token can be modified from the issuer side, when the network token status has been updated, EVO Cloud will send a notification to the merchant webhook which is set in POST Payment or POST PaymentMethod used to create the gateway token.

In the scenarios below, EVO Cloud will send notifications to the specified webhook.

ScenarioeventCode in notification
Network Token DeletedNetworkTokenDeleted
Network Token UpdatedNetworkTokenStatusUpdated

Network Token Deleted

Cardholder maybe delete their network token form issuer side. In this case, EVO will notify the merchant through an asynchronous notification. Merchant will receive a notification which contains below fields:

  1. eventCode: The fixed value NetworkTokenDeleted.
  2. paymentMethod.networkToken.status: The status of the network token. When the network token has been deleted, the value of this field is disable.
  3. paymentMethod.token.status: The status of the gateway token. The value of this field is enabled.
  4. paymentMethod.networkToken.tokenID: The unique ID of the network token assigned by card scheme.
  5. paymentMethod.token.value: The gateway token value generated by EVO Cloud.

No matter network token has been deleted, the gateway token will enable to make payment.

Network Token Updated

Sometimes the issuer will update the network token’s information, such as: update expire data; network token suspended. EVO will notify the merchant through an asynchronous notification which contains below fields:

  1. eventCode: The fixed value NetworkTokenStatusUpdated.
  2. paymentMethod.networkToken.status: The status of the network token. When the network token has been suspended, the value of this field is supended. In other cases, the value of this field will be enable.
  3. paymentMethod.networkToken.expiryDate: The expiry date of network token.
  4. paymentMethod.networkToken.first6No: The first 6 digits of the network token.
  5. paymentMethod.networkToken.last4No: The last 4 digits of the network token.
  6. paymentMethod.token.status: The status of the gateway token. The value of this field is enabled.
  7. paymentMethod.networkToken.tokenID: The unique ID of the network token assigned by card scheme.
  8. paymentMethod.token.value: The gateway token value generated by EVO Cloud.