# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nymcard.com/get-started/webhooks/ncore-webhook-events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.