Network Tokens Webhooks

Network Tokens Webhooks - Mock Testing

You can test the various Network Token notifications using the mocks and the following methods:

Method 1: Fixed Card Numbers for Specific Responses

Using specific card numbers with the Create Card API, you can simulate fixed Network Token notifications. The following table lists card numbers and the corresponding Network Token notifications you will receive upon making an enrollment/create card request:

Test Cards
Expiry Date
Notification Event-Triggered
VGS Event/State/Reason_Code
Expected Responses

5100260000039220

Any Future Date

CARD_UPDATED

Event: cmp_network_token.updated State: CARD_UPDATED Reason_code: cmp_card_updated

1. Sync response: Card Object Creation Successful 2. Async notification: Card Updated Notification 3. GET response: Card and Network Token (card_updated status) objects are available

5100260000029221

Any Future Date

SUSPENDED

Event: cmp_network_token.updated State: SUSPENDED Reason_code: cmp_network_token.suspended

1. Sync response: Card Object Creation Successful 2. Async notification: Suspended Notification 3. GET response: Card and Network Token (suspended status) objects are available

5100260000019222

Any Future Date

ACTIVE

Event: cmp_network_token.updated State: ACTIVATED Reason_code: cmp_network_token.activated

1. Sync response: Card Object Creation Successful 2. Async notification: Activated Notification 3. GET response: Card and Network Token (activated status) objects are available

5100260000009223

Any Future Date

DELETED

Event: cmp_network_token.updated State: DELETED Reason_code: cmp_network_token.deleted

1. Sync response: Card Object Creation Successful 2. Async notification: Deleted Notification 3. GET response: Card and Network Token (deleted status) objects are available

5100260000099224

Any Future Date

PROVISIONING SUCCESSFUL

Event: cmp_network_token.updated State: ACTIVE Reason_code: cmp_network_token.provisioned

1. Sync response: Card Object Creation Successful 2. Async notification: Successfully Provisioned Notification 3. GET response: Card and Network Token (active status) objects are available

5100260000089225

Any Future Date

PROVISIONING FAILED

Event: cmp_network_token.updated State: FAILED Reason_code: cmp_network_token.provisioning_failed

1. Sync response: Card Object Creation Successful 2. Async notification: Provisioning Failed Notification 3. GET response: Card and Network Token (failed status) objects are available

4000210000029220

Any Future Date

CARD_UPDATED

Event: cmp_network_token.updated State: CARD_UPDATED Reason_code: cmp_card_updated

1. Sync response: Card Object Creation Successful 2. Async notification: Card Updated Notification 3. GET response: Card and Network Token (card_updated status) objects are available

4000210000019221

Any Future Date

SUSPENDED

Event: cmp_network_token.updated State: SUSPENDED Reason_code: cmp_network_token.suspended

1. Sync response: Card Object Creation Successful 2. Async notification: Suspended Notification 3. GET response: Card and Network Token (suspended status) objects are available

4000210000009222

Any Future Date

ACTIVE

Event: cmp_network_token.updated State: ACTIVATED Reason_code: cmp_network_token.activated

1. Sync response: Card Object Creation Successful 2. Async notification: Activated Notification 3. GET response: Card and Network Token (activated status) objects are available

4000210000099223

Any Future Date

DELETED

Event: cmp_network_token.updated State: DELETED Reason_code: cmp_network_token.deleted

1. Sync response: Card Object Creation Successful 2. Async notification: Deleted Notification 3. GET response: Card and Network Token (deleted status) objects are available

4000210000089224

Any Future Date

PROVISIONING SUCCESSFUL

Event: cmp_network_token.updated State: ACTIVE Reason_code: cmp_network_token.provisioned

1. Sync response: Card Object Creation Successful 2. Async notification: Successfully Provisioned Notification 3. GET response: Card and Network Token (active status) objects are available

4000210000079225

Any Future Date

PROVISIONING FAILED

Event: cmp_network_token.updated State: FAILED Reason_code: cmp_network_token.provisioning_failed

1. Sync response: Card Object Creation Successful 2. Async notification: Provisioning Failed Notification 3. GET response: Card and Network Token (failed status) objects are available

Known Fact about Network Token Notifications Mock Implementation: In the mock environment, the synchronous response from the Create Card API returns the expected cardID—which matches the Network Token notifications—and accurately replicates the card number, BIN, first 8 digits, and last 4 digits as provided in the request. However, the address and expiration date fields in the mock response will not match the values from the original request.

Method 2: Any PAN with Specific Mastercard or Visa Bins + Last4

You can also test Account Updater notifications by using any PAN (Primary Account Number) that starts with the Mastercard BIN (510026) or Visa BIN (400021) and ends with a last4 in the range 9220-9225. Simply trigger the Create Card/Enrollment process using these PANs. In the Network Token notifications, network_token_bin has been added. We have also added a new Reason_code field to help uniquely identify the Network Token event triggered.

To receive these notifications please ensure to set up the webhook URL on the dashboard. See here for details on notification set-up.

Test Cards
Expiry Date
Notification Event-Triggered
VGS Event
Expected Response

510026******9220

Any Future Date

CARD_UPDATED

Event: cmp_network_token.updated State: CARD_UPDATEDReason_code: cmp_card_updated

1. Sync response: Card Object Creation Successful 2. Async notification: Card Updated Notification 3. GET response: Card and Network Token (card_updated status) objects are available

510026******9221

Any Future Date

SUSPENDED

Event: cmp_network_token.updated State: SUSPENDEDReason_code: cmp_network_token.suspended

1. Sync response: Card Object Creation Successful 2. Async notification: Suspended Notification 3. GET response: Card and Network Token (suspended status) objects are available

510026******9222

Any Future Date

ACTIVE

Event: cmp_network_token.updated State: ACTIVATEDReason_code: cmp_network_token.activated

1. Sync response: Card Object Creation Successful 2. Async notification: Activated Notification 3. GET response: Card and Network Token (activated status) objects are available

510026******9223

Any Future Date

DELETED

Event: cmp_network_token.updated State: DELETEDReason_code: cmp_network_token.deleted

1. Sync response: Card Object Creation Successful 2. Async notification: Deleted Notification 3. GET response: Card and Network Token (deleted status) objects are available

510026******9224

Any Future Date

PROVISIONING SUCCESSFUL

Event: cmp_network_token.updated State: ACTIVEReason_code: cmp_network_token.provisioned

1. Sync response: Card Object Creation Successful 2. Async notification: Successfully Provisioned Notification 3. GET response: Card and Network Token (active status) objects are available

510026******9225

Any Future Date

PROVISIONING FAILED

Event: cmp_network_token.updated State: FAILEDReason_code: cmp_network_token.provisioning_failed

1. Sync response: Card Object Creation Successful 2. Async notification: Provisioning Failed Notification 3. GET response: Card and Network Token (failed status) objects are available

400021******9220

Any Future Date

CARD_UPDATED

Event: cmp_network_token.updated State: CARD_UPDATEDReason_code: cmp_card_updated

1. Sync response: Card Object Creation Successful 2. Async notification: Card Updated Notification 3. GET response: Card and Network Token (card_updated status) objects are available

400021******9221

Any Future Date

SUSPENDED

Event: cmp_network_token.updated State: SUSPENDEDReason_code: cmp_network_token.suspended

1. Sync response: Card Object Creation Successful 2. Async notification: Suspended Notification 3. GET response: Card and Network Token (suspended status) objects are available

400021******9222

Any Future Date

ACTIVE

Event: cmp_network_token.updated State: ACTIVATEDReason_code: cmp_network_token.activated

1. Sync response: Card Object Creation Successful 2. Async notification: Activated Notification 3. GET response: Card and Network Token (activated status) objects are available

400021******9223

Any Future Date

DELETED

Event: cmp_network_token.updated State: DELETEDReason_code: cmp_network_token.deleted

1. Sync response: Card Object Creation Successful 2. Async notification: Deleted Notification 3. GET response: Card and Network Token (deleted status) objects are available

400021******9224

Any Future Date

PROVISIONING SUCCESSFUL

Event: cmp_network_token.updated State: ACTIVEReason_code: cmp_network_token.provisioned

1. Sync response: Card Object Creation Successful 2. Async notification: Successfully Provisioned Notification 3. GET response: Card and Network Token (active status) objects are available

400021******9225

Any Future Date

PROVISIONING FAILED

Event: cmp_network_token.updated State: FAILEDReason_code: cmp_network_token.provisioning_failed

1. Sync response: Card Object Creation Successful 2. Async notification: Provisioning Failed Notification 3. GET response: Card and Network Token (failed status) objects are available

Method 3: Network Token Mock Webhook Notifications with Networks

Both Visa and Mastercard Network Token notifications cannot be tested because both networks do not provide a mock environment for Network Token webhook notifications. Please refer to Method 1 above to test Network Token Notifications.

Network Token Provisioning Failure Reason Codes

Reason Code
Reason Text

card_enrollment_failed

Invalid payment instrument or data associated with the payment instrument

card_not_allowed

Card cannot be used for tokenization at this moment. Please try again later

card_not_allowed

The requested action is not allowed for a given PAN. This card is valid but cannot be used for tokenization.

declined

This card is not eligible for tokenization at this moment with the Network; Retry at a later time.

declined

No further operations are allowed. Contact bank

service_unavailable

Downstream service unavailable; retry later

rejected

This card is not eligible for tokenization at this moment with the Network; Retry later.

Notifications Set Up

You can configure a webhook to receive updates for the Network Token. For detailed instructions on setting up notifications, click here.

Last updated