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 Card Number
Test CardIDs
Expiration Date
Notification Event-Triggered
VGS Event/State/Reason_Code
Expected Responses

5100260000039220

CRDpqQNTZMPkjFh4iQJ28grPyZYfPy4nZodLgMPDyK4qEvUpXXQ2

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

CRDLDNW4pyFMq2meBi3vp5Z88ff8Q8WCKbctmD7hL6CFrCuZGj4T

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

CRDrc7GJqNHVAqX3eQFspL2eN7b6gRvj43Q4KRSpiqFEVJotEUcX

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

CRDqj7n3kRVAmBsD3WkArj4M9tUAh5eDxXpMURUwydPHQ8YSK42F

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

CRDM1tW9LGUPXHH9BGPePkzC1PNTshezGBHyqURv7K771rQuQpuy

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

CRDpX9ZT8hZtEorWeqb7AhEFmVg4NyvZybBhiJ2W5koED8asxcDv

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

CRDoxCWvA7CmBLR1mdsirzmtrECuUX1c5G3iqP6HV83zPPcRB7vE

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

CRDM6gJUNUt8BaxaPrJ46jJn6K9NZAN1ip71FrjzDoPe3DKw1wnW

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

CRDoCwtdKzpDxbn1sowRCiPRneCMmhm6EogQGKGGi47Eh6KPXzj3

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

CRDqjBoPbYX9ZtVXpDX2vvSmtpUFq9DUHcbZUuTQ3XeXP8rxgge2

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

CRDpSY16wcG9484FtM2h7DEhXkeQXdMaTpeJTaEvfutjnJa9BBTw

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

CRDKLBY6Es9jW8vyJZnTPFWNNZVBVhWeoJJUUHZqWpvPhHxq1EmY

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 using any 16-digit PAN (Primary Account Number) that starts with the Mastercard BIN (510026) or Visa BIN (400021) and ends with a last4 value in the range 92209225. To do this, trigger the Create Card/Enrollment flow with a PAN constructed using the specified BIN and one of the supported last4 values. For Network Token notifications, the network_token_bin field has been added. We have also added a new reason_code field to help uniquely identify the Network Token event that was 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