Network Tokens Events

Network Tokens Events

After a Network Token has been enrolled, there are a few key events that may occur. These fall into two broad categories:

• Lifecycle Events: These represent billable actions that typically result in a change to the card metadata or indicate successful provisioning.

• Status Updates: These reflect changes to the token's status (e.g., suspended or deleted) and are not billable. You may receive these events via our Webhook integration or view them in the Usage Reports section of your organization's Dashboard. Below is an explanation of each:

Network token events

After a Network Token has been enrolled, there are a few key events that may occur. These fall into two broad categories:

• Lifecycle Events: These represent billable actions that typically result in a change to the card metadata.
• Status Updates: These reflect changes to the token's status (e.g., suspended or deleted) and are not billable. You may receive these events via our Webhook integration or view them in the Usage Reports section of your organization's Dashboard.

Payload

descriptionstringRequired

eventstringRequired

fingerprintstringRequired

groupingstringRequired

idstringRequired

integration_idstringRequired

occurrenceintegerRequired

org_idstringRequired

scopestringRequired

summarystringRequired

tenantstringRequired

timestampstringRequired

Responses

200

Return a 200 status to indicate that the data was received successfully.

No content

Payload

{
  "description": "Network token updated",
  "details": {
    "pan_alias": "5114103XX3542294",
    "card_bin": "511410",
    "card_exp_month": "12",
    "card_exp_year": "2027",
    "card_last4": "2293",
    "created_at": "2025-12-12T09:59:44.667670",
    "exp_month": "12",
    "exp_year": "2029",
    "network_token": "",
    "network_token_id": "0e28d9f6-d8a3-43ca-9bd8-b99c477c2b4c1",
    "network_token_last4": "5022",
    "payment_account_reference": "",
    "state": "ACTIVE",
    "tenant_id": "tntt0fzksdr"
  },
  "event": "network_token.updated",
  "fingerprint": "f438b385c1ed2c40a9379fcea75b3a40eec865fa3c9d0812ab212d45e5a84eca",
  "grouping": "every_single",
  "id": "7a4a31dd-8494-4400-8c19-0e88b814089c",
  "integration_id": "INvwsS1BGFs6ZjQ2eCiv9JV1",
  "occurrence": 1,
  "org_id": "ACgzdqxQb4RyPyWsw97DVDDD",
  "producer": {
    "application_name": "calm-api",
    "application_protocol": "http"
  },
  "scope": "vault",
  "summary": "\"A Network Token for 5114103XX3542294 pan alias has been updated in vault tntt0fzksdr\"\n",
  "tenant": "tntt0fzksdr",
  "timestamp": "2026-06-18T06:23:48.711Z"
}

Network Token Status	VGS Network Token State	VGS Reason Code	Description	Classification Type
Updated	updated	network_token.updated	The network has updated the card metadata	Lifecycle Event
Activated	activated	network_token.activated	A network token has been activated following a suspension.	Status Update
Suspended	suspended	network_token.suspended	A network token has been suspended by the issuing card network (Mastercard, Visa, etc).	Status Update
Deleted	deleted	network_token.deleted	A network token has been deleted via the API, or a Delete was triggered from the issuing bank	Status Update

Network Tokens Provisioning Errors

Network	Status/Error Code	Description
Visa	400 - InvalidParameter	These declines means that Visa declined it before sending to issuer because the PAN information is invalid.
Visa	400 - card_enrollment_failed	Invalid payment instrument or data associated with the payment instrument; Invalid input to pan/expiry date.
Visa	403- card_not_allowed	Card cannot be used for tokenization at this moment. Please try again later. Something is wrong with the PAN itself. The PAN was expired for instance.
Visa	403 - declined	This card is not eligible for tokenization at this moment with the Network; Retry at a later time.
Visa	409 - declined	No further operations are allowed. Contact bank
Visa	500 -Service Unavailable	Downstream service unavailable; retry later.
Visa	503 -notReady	The server is currently unable to handle the request due to a temporary overloading or maintenance of the server.
Mastercard	400 - card_enrollment_failed	Invalid payment instrument or data associated with the payment instrument; Invalid input to pan/expiry
Mastercard	403 -rejected	This card is not eligible for tokenization at this moment with the Network; Retry later.
Mastercard	503 -Service Unavailable	Downstream service unavailable; retry later
Mastercard	503 -Service Unavailable	Downstream service unavailable; retry later

Network Tokens Crypto Fetch Network Errors

Network	Status/Error Code	Description
Visa	403 - declined	This card is not eligible for tokenization at this moment with the Network; Retry at a later time.
Visa	409 - declined	No further operations are allowed. Contact bank
Visa	400 - rejected	Invalid payment instrument or data associated with the payment instrument; Invalid input to pan/expiry date.
Mastercard	400 invalid_argument	Incorrect/missing fields or values.
Mastercard	401 - cannot_be_null	The request contains card type, but the card type does not correspond with the card number (e.g. card type = Visa; card number = MasterCard)