> For the complete documentation index, see [llms.txt](https://docs.nymcard.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nymcard.com/get-started/webhooks/ncore-webhook-events.md).

# nCore webhook events

Following are the available webhooks you can create to receive event notifications.

| **Event name**           | **Event type**                    | **Send webhook notification when**          |
| ------------------------ | --------------------------------- | ------------------------------------------- |
| Status change            | CARD\_STATUS\_CHANGE              | A card status is updated                    |
| Transaction              | TRANSACTION                       | A transaction is performed by a card        |
| KYC                      | KYC\_RESULT                       | Changes in user’s KYC request are done      |
| User creation            | USER\_CREATED                     | User is created                             |
| User status              | USER\_STATUS\_CHANGE              | User status is changed                      |
| User document            | USER\_DOCUMENT\_ALERT             | The document expiration date is approaching |
| IDV                      | IDENTITY\_VERIFICATION            | Identity verification needed                |
| PIN change               | PIN\_CHANGE                       | PIN is changed                              |
| Auth expiry              | EXPIRED\_AUTH                     | Auth/pre-auth is expired                    |
| Charges                  | CHARGE\_APPLIED                   | Charges are applied                         |
| Account status           | ACCOUNT\_STATUS\_CHANGE           | Account status is changed                   |
| Card provisioning        | CARD\_PROVISIONING                | Card is tokenized                           |
| Token notification       | TOKEN\_NOTIFICATION               | Digital wallet token status is updated      |
| Card or account creation | SUCCESSFULLY\_CREATED             | Card or account is successfully created     |
| Card delivery            | CARD\_DELIVERY\_PARTNER\_ASSIGNED | Card delivery partner is assigned           |
| Card delivery            | CARD\_DELIVERY\_STATUS\_CHANGED   | Card delivery status is changed             |

**Handling**

Following are the methods in which nCore platform handles webhooks notifications.

* The nCore platform maintains a retry counter and resends the failed notifications by triggering the expired webhooks.
* It includes a Basic Auth (encoded in base64) header in the webhook notification message.
* The nCore platform pings a configured webhook to validate the credential and connectivity.
* To support token uniqueness, each transaction is recognized by a unique transaction token, and each webhook is identified by a unique event token.