> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Event types

This page lists the event types for which Mangopay can send webhook notifications.

The event types are listed by feature for each `RessourceId` on which they occur. Alongside is the GET API call you can use to confirm the event is still valid and retrieve more details, as well as the related guide pages.

To listen to an event type on your chosen URL, set up a webhook in the <a href="https://hub.mangopay.com/" target="_blank">Mangopay Dashboard</a> (***Developers*** > ***Webhooks***) or using the [POST Create a Hook](/api-reference/webhooks/create-hook) endpoint.

[Learn more about webhooks](/webhooks) **→**

## User management

### User regulatory status

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a User's regulatory status](/api-reference/user-regulatory-status/view-user-regulatory-status)</td>
  </tr>

  <tr>
    <th class="header">Related guide</th>
    <td class="table-content">[Blocked users](/guides/users/blocked-users)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_INFLOWS_BLOCKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The User has been blocked by Mangopay and can no longer make pay-ins or send or receive transfers.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_INFLOWS_UNBLOCKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The User has been unblocked by Mangopay and can now make pay-ins or send or receive transfers.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_OUTFLOWS_BLOCKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The User has been blocked by Mangopay and can no longer make payouts or send or receive transfers.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_OUTFLOWS_UNBLOCKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The User has been unblocked by Mangopay and can now make payouts or send or receive transfers.
    </td>
  </tr>
</table>

### User account

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a User (SCA)](/api-reference/users/view-user-sca)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[SCA](/guides/sca/users)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_ACCOUNT_VALIDATION_ASKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Owner User (Natural or Legal Soletrader) has triggered SCA enrollment or re-enrollment via a User endpoint. Their access to SCA-triggering actions is restricted until they complete the SCA redirection to enroll successfully.

      <br />

      <br />

      This event is only triggered when the User's `UserStatus` changes to `PENDING_USER_ACTION`, which only happens in the situations described [here](/guides/sca/users#pending-user-action).

      <br />

      <br />

      To obtain a new SCA redirection link to retry enrollment, call the [POST Enroll a User](/api-reference/users/enroll-user) endpoint.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_ACCOUNT_ACTIVATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Owner User (Natural or Legal Soletrader) completed an SCA session successfully, and can now access Mangopay features.

      <br />

      <br />

      This event is only triggered when the User's `UserStatus` changes from `PENDING_USER_ACTION` to `ACTIVE`.
    </td>
  </tr>
</table>

#### Account closure

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_ACCOUNT_CLOSED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The User (Owner or Payer) was permanently closed and their `UserStatus` changed to `CLOSED`.

      <br />

      <br />

      The User was closed either by the platform, using the dedicated endpoint for [Natural](/api-reference/users/close-natural-user) or [Legal](/api-reference/users/close-legal-user) users, or by Mangopay as per the terms and conditions.

      <br />

      <br />

      A user can only be closed if all the wallets they hold are empty.
    </td>
  </tr>
</table>

### Mangopay SCA enrollment

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a User (SCA)](/api-reference/users/view-user-sca)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[SCA](/guides/sca)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_ENROLLMENT_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user enrolled in Mangopay's SCA feature successfully.

      <br />

      <br />

      This event is triggered by any new enrollment (or re-enrollment) prompted by an API call, regardless of the endpoint that returned the SCA redirection link (users, recipients, transfers, wallets – see [full list of endpoints](/guides/sca/session#1-call-an-endpoint-that-triggers-sca-redirection)).

      <br />

      <br />

      This event is not triggered by authentication challenges once the user is enrolled.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_ENROLLMENT_EXPIRED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The SCA enrollment session expired after 10 minutes before the user completed all steps to enroll all factors. To retry the enrollment, call another API [endpoint that triggers SCA](/guides/sca/session#1-call-an-endpoint-that-triggers-sca-redirection).

      <br />

      <br />

      This event is not triggered by authentication challenges once the user is enrolled.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_ENROLLMENT_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user attempt enrollment but reached the maximum number of retries for one of the factors. To retry the enrollment, call another API [endpoint that triggers SCA](/guides/sca/session#1-call-an-endpoint-that-triggers-sca-redirection).

      <br />

      <br />

      This event is not triggered by authentication challenges once the user is enrolled.
    </td>
  </tr>
</table>

### Mangopay SCA email and phone number verification

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a User (SCA)](/api-reference/users/view-user-sca)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[SCA](/guides/sca)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_EMAIL_VERIFIED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The email address required for SCA was successfully verified by the completion of an SCA session after it was added or changed via an API call.

      <br />

      <br />

      Note that a user cannot modify their email address from within an SCA session.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_PHONE_NUMBER_VERIFIED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The phone number used for SCA's OTP factor was verified by the completion of an SCA session after it was changed either from within an SCA session or via an API call.
    </td>
  </tr>
</table>

### Proxy consent status for SCA-triggering action scopes

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View the SCA status of a User (SCA)](/api-reference/users/view-user-sca-status)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[SCA](/guides/sca/proxy-management)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_CONTACT_INFORMATION_UPDATE_CONSENT_GIVEN`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user checked the checkbox (and completed the SCA session) to give consent for your platform to update the User's SCA contact information on their behalf, which you can do by setting `ScaContext` to `USER_NOT_PRESENT` in a call to:

      * [PUT Update a Natural User (SCA)](/api-reference/users/update-natural-user-sca) to modify the `PhoneNumber`, `PhoneNumberCountry`, or `Email`
      * [PUT Update a Legal User (SCA)](/api-reference/users/update-legal-user-sca) to modify the `PhoneNumber`, `PhoneNumberCountry`, or `Email` of the `LegalRepresentative`
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_TRANSFER_CONSENT_GIVEN`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user checked the checkbox (and completed the SCA session) to give consent for your platform to initiate a transfer to another `OWNER` user on their behalf, which you can do by setting `ScaContext` to `USER_NOT_PRESENT` in a call to:

      * [POST Create a Transfer](/api-reference/transfers/create-transfer)
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_RECIPIENT_REGISTRATION_CONSENT_GIVEN`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user checked the checkbox (and completed the SCA session) to give consent for your platform to register an external bank or payment account on their behalf, which you can do by setting `ScaContext` to `USER_NOT_PRESENT` in a call to:

      * [POST Create a Recipient](/api-reference/recipients/create-recipient)
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_GIVEN`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user checked the checkbox (and completed the SCA session) to give consent for your platform to retrieve wallet and transaction data on their behalf, which you can do by setting `ScaContext` to `USER_NOT_PRESENT` in a call to:

      * [GET View a Wallet](/api-reference/wallets/view-wallet)
      * [GET List Wallets for a User](/api-reference/wallets/list-wallets-user)
      * [GET List Transactions for a User](/api-reference/transactions/list-transactions-user)
      * [GET List Transactions for a Wallet](/api-reference/transactions/list-transactions-wallet)
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_CONTACT_INFORMATION_UPDATE_CONSENT_REVOKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user unchecked the checkbox (and completed the SCA session) to revoke consent to your platform updating the User's SCA contact information on their behalf.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_TRANSFER_CONSENT_REVOKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user unchecked the checkbox (and completed the SCA session) to revoke consent for your platform to initiate a transfer to another `OWNER` user on their behalf.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_RECIPIENT_REGISTRATION_CONSENT_REVOKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user unchecked the checkbox (and completed the SCA session) to revoke consent for your platform to register an external bank or payment account on their behalf.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SCA_VIEW_ACCOUNT_INFORMATION_CONSENT_REVOKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The user checked the checkbox (and completed the SCA session) to give consent for your platform to retrieve wallet and transaction data on their behalf
    </td>
  </tr>
</table>

### User category

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a User (SCA)](/api-reference/users/view-user-sca)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Categories](/guides/users/categories)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_CATEGORY_UPDATED_TO_OWNER`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The existing user's `UserCategory` was changed to `OWNER`.

      <br />

      <br />

      This event is not triggered if `OWNER` is set at user creation. This event usually coincides with SCA, triggering `USER_ACCOUNT_VALIDATION_ASKED`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_CATEGORY_UPDATED_TO_PAYER`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The existing user's `UserCategory` was changed to `PAYER`. Re-categorization from `OWNER` to `PAYER` is only possible by Mangopay.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_CATEGORY_UPDATED_TO_PLATFORM`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The existing user's `UserCategory` was changed to `PLATFORM`. Categorization as `PLATFORM` is only possible by Mangopay.
    </td>
  </tr>
</table>

### User KYC status

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a User (SCA)](/api-reference/users/view-user-sca)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[User KYC/KYB verification](/guides/users/verification)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_KYC_LIGHT`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The User is not KYC/KYB verified by Mangopay and is therefore subject to KYC/KYB verification [limits](/guides/users/limits).

      <br />

      <br />

      The User's `KYCLevel` has changed from `REGULAR` to `LIGHT`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`USER_KYC_REGULAR`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The User was KYC/KYB verified by Mangopay.

      The User's `KYCLevel` changed from `LIGHT` to `REGULAR`.
    </td>
  </tr>
</table>

### IDV session

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`IdvSessionId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View an IDV Session](/api-reference/idv-sessions/view-idv-session)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Hosted KYC/KYB solution](/guides/users/verification/hosted)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`IDENTITY_VERIFICATION_PENDING`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The IDV Session’s `Status` is `PENDING`. The `HostedUrl` link is valid for completion and must be submitted within 7 days. The session may or may not have been started.

      <br />

      <br />

      After 7 days, the `Status` of the IDV Session object changes to `EXPIRED` and can no longer be submitted. However, the link returned on `HostedUrl` remains active.

      <br />

      <br />

      Note that there is not yet a webhook notifying you when the session expires after 7 days from the `CreationDate`, so you need to track this on your side.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`IDENTITY_VERIFICATION_VALIDATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The IDV Session’s `Status` changed to `VALIDATED` and the User became KYC/KYB verified.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`IDENTITY_VERIFICATION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The IDV Session’s `Status` changed to `REFUSED` and the User was not KYC/KYB verified. A new session is needed for them to retry.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`IDENTITY_VERIFICATION_INCONCLUSIVE`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The IDV Session’s `Status` changed to `REVIEW` and the session is under manual review by Mangopay’s teams before an outcome can be given.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`IDENTITY_VERIFICATION_OUTDATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The IDV Session’s `Status` changed to `OUT_OF_DATE` indicating that the user’s KYC/KYB verification status was [downgraded](/guides/users/verification/downgrade). To regain KYC/KYB verified status, the user must complete a new IDV Session successfully.
    </td>
  </tr>
</table>

### User data format

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UserId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a User (SCA)](/api-reference/users/view-user-sca)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Company number](/guides/users/verification/company-number)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`LEGAL_COMPANY_NUMBER_VALIDATION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The format of the company number is not valid for the headquarters address country of the Business-type Legal User. A invalid format blocks verification.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`LEGAL_COMPANY_NUMBER_VALIDATION_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The format of the company number is valid for the headquarters address country of the Business-type Legal User. The format is as expected for the country of registration but the veracity of the data has not yet been verified.
    </td>
  </tr>
</table>

### KYC documents

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`KYCDocumentId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a KYC Document](/api-reference/kyc-documents/view-kyc-document)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Submitting KYC documents](/guides/users/verification/documents/submission)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`KYC_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The KYC Document has been created but not yet submitted for review.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`KYC_VALIDATION_ASKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The KYC Document has been submitted for validation and is being processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`KYC_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The KYC Document has been validated by Mangopay.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`KYC_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The KYC Document has been refused by Mangopay.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`KYC_OUTDATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The KYC Document is no longer valid. This is due to an amendment of the user's identity or other key details as per the KYC/KYB verification [downgrade](/guides/users/verification/downgrade).
    </td>
  </tr>
</table>

### UBO declarations

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`UboDeclarationId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a UBO Declaration](/api-reference/ubo-declarations/view-ubo-declaration)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Beneficial owners](/guides/users/verification/beneficial-owners)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`UBO_DECLARATION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The UBO Declaration has been created but not yet submitted for review.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`UBO_DECLARATION_VALIDATION_ASKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The UBO Declaration has been submitted for validation and is being processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`UBO_DECLARATION_VALIDATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The UBO Declaration has been validated by the Mangopay Compliance team.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`UBO_DECLARATION_INCOMPLETE`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The UBO Declaration is incomplete and additional information or documents may be required.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`UBO_DECLARATION_REFUSED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The UBO Declaration has been refused by Mangopay.
    </td>
  </tr>
</table>

## Country authorizations

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`CountryCode`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View authorizations for a country](/api-reference/country-authorizations/view-authorizations-country)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Country restrictions](/guides/users/country-restrictions)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`COUNTRY_AUTHORIZATION_UPDATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The restrictions related to a country have been updated.
    </td>
  </tr>
</table>

## Recipients

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`RecipientId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Recipient](/api-reference/recipients/view-recipient)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Recipients](/guides/sca/recipients)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`RECIPIENT_ACTIVE`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Recipient was created successfully, including the SCA session if `RecipientScope` is `OWNER`, and it can now be used for payments.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`RECIPIENT_CANCELED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Recipient creation was unsuccessful because the SCA session was not successful. The `CANCELED` status is only relevant if `RecipientScope` is `OWNER`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`RECIPIENT_DEACTIVATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Recipient was permanently deactivated and can no longer be used.
    </td>
  </tr>
</table>

## Pay-ins

### All payment methods

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`PayInId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a PayIn (Direct Card)](/api-reference/direct-card-payins/view-payin-direct-card) for example – same endpoint for all payment methods, different response object</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[All payment methods](/guides/payment-methods)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_NORMAL_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The PayIn transaction has been created but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_NORMAL_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The PayIn transaction has been successfully processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_NORMAL_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The PayIn transaction has failed.
    </td>
  </tr>
</table>

### Card payments

#### Card validations

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`CardValidationId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Card Validation](/api-reference/card-validations/view-card-validation)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Card validation without debit](/guides/payment-methods/card/validation)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`CARD_VALIDATION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Card Validation object has been created and the card is pending validation.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`CARD_VALIDATION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Card Validation has failed, setting the corresponding card as invalid.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`CARD_VALIDATION_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Card Validation has succeeded, setting the corresponding card as valid.
    </td>
  </tr>
</table>

#### Recurring pay-in registrations

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`RecurringRegistrationId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Recurring PayIn Registration](/api-reference/recurring-payin-registrations/view-recurring-payin-registration)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Recurring card payments](/guides/payment-methods/card/recurring)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`RECURRING_REGISTRATION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Recurring Registration object has been successfully created.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`RECURRING_REGISTRATION_AUTH_NEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      A pay-in against this recurring object requires authentication.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`RECURRING_REGISTRATION_IN_PROGRESS`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Recurring Registration object is in a valid state. Pay-ins against this recurring registration are possible.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`RECURRING_REGISTRATION_ENDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Recurring Registration object has been ended. It is no longer possible to make pay-ins against this recurring registration.
    </td>
  </tr>
</table>

#### Preauthorizations

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`PreauthorizationId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Preauthorization](/api-reference/preauthorizations/view-preauthorization)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[7-day preauthorization](/guides/payment-methods/card/preauthorization)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PREAUTHORIZATION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Preauthorization object has been successfully created.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PREAUTHORIZATION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The authorization of this Preauthorization has failed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PREAUTHORIZATION_PAYMENT_CANCELED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The authorization of this Preauthorization has been canceled.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PREAUTHORIZATION_PAYMENT_EXPIRED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The authorization of this Preauthorization has expired.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PREAUTHORIZATION_PAYMENT_VALIDATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Preauthorization has been successfully debited.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PREAUTHORIZATION_PAYMENT_WAITING`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Preauthorization object can now be debited.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PREAUTHORIZATION_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The authorization of this Preauthorization has been successful.
    </td>
  </tr>
</table>

#### Deposit preauthorizations

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`DepositId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>

    <td class="table-content">
      * Card – [GET View a Deposit Preauthorization](/api-reference/deposit-preauthorizations/view-deposit-preauthorization)
      * PayPal – [GET View a Deposit Preauthorization](/api-reference/deposit-preauthorizations/view-deposit-preauthorization)
    </td>
  </tr>

  <tr>
    <th class="header">Related guides</th>

    <td class="table-content">
      * Card – [30-day deposit preauthorization](/guides/payment-methods/card/deposit-preauthorization)
      * PayPal – [PayPal deposit preauthorization](/guides/payment-methods/paypal#preatuhorized-payments)
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Deposit Preauthorization object has been successfully created.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_PAYMENT_WAITING`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The authorization of the Deposit Preauthorization has been successful. It can now be debited.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_PAYMENT_VALIDATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Deposit Preauthorization has been successfully debited: a successful pay-in against the preauthorization has been made. No further action can be taken.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_PAYMENT_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The payment action against the Deposit Preauthorization has failed. A retry may be possible.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The authorization of the Deposit Preauthorization has failed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_PAYMENT_CANCEL_REQUESTED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The request to cancel the Deposit Preauthorization has been taken into account.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_PAYMENT_CANCELED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Deposit Preauthorization has been successfully canceled.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DEPOSIT_PREAUTHORIZATION_PAYMENT_EXPIRED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The authorization of the Deposit Preauthorization has expired.
    </td>
  </tr>
</table>

### Banking payments

#### Pay by bank

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`PayInId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a PayIn (Pay by Bank)](/api-reference/pay-by-bank/view-payin-pay-by-bank)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Pay by Bank](/guides/payment-methods/banking/pay-by-bank)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_NORMAL_PROCESSING_STATUS_PENDING_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Pay by Bank PayIn has been successfully initiated by the user. The funds have not yet arrived on Mangopay’s bank account and the pay-in `Status` is still `CREATED`.
    </td>
  </tr>
</table>

#### Virtual accounts

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`VirtualAccountId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Virtual Account](/api-reference/virtual-accounts/view-virtual-account)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Virtual accounts](/guides/payment-methods/banking/virtual-iban)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`VIRTUAL_ACCOUNT_ACTIVE`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The account is active and can receive funds (see note about delayed [UK CoP recognition](#set-up-the-account) for `GB` accounts).
    </td>
  </tr>

  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`VIRTUAL_ACCOUNT_BLOCKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The account is blocked and is not active. Any funds sent to the account are returned. This temporary status may be used during processes relating to user verification or fraud screening.
    </td>
  </tr>

  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`VIRTUAL_ACCOUNT_CLOSED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The account has been deactivated and is closed. Any funds sent to the account are returned. This is a final state.
    </td>
  </tr>

  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`VIRTUAL_ACCOUNT_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The account creation request failed or was rejected. This final state is rare. Any funds sent to the account are returned (if account details exist).
    </td>
  </tr>
</table>

#### Direct debit mandates

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`MandateId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Mandate](/api-reference/mandates/view-mandate)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Direct debit mandates](/guides/payment-methods/banking/direct-debit)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`MANDATE_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Mandate has been created.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`MANDATE_SUBMITTED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Mandate has been successfully validated, an email has been sent to the end user (if emails are configured).
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`MANDATE_ACTIVATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Mandate request has been successfully created and validated. A bank wire can be initiated.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`MANDATE_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Mandate request has failed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`MANDATE_EXPIRED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Mandate has expired. It is no longer possible to make bank wire pay-ins against this mandate.
    </td>
  </tr>
</table>

## Disputes

### Disputes

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`DisputeId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Dispute](/api-reference/disputes/view-dispute)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Disputes](/guides/disputes)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute has been created. It can either be closed directly or reviewed by the platform.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_ACTION_REQUIRED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The contestable Dispute requires further action. The platform is notified by Mangopay in a short period of time.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_SUBMITTED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute has been contested by the platform, either entirely or partially.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_SENT_TO_BANK`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute has been sent to the bank for review and approval following the Dispute Documents validation.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_FURTHER_ACTION_REQUIRED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      To settle the Dispute, additional documents are required.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_CLOSED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute has been closed. It can either be `WON` or `LOST` by the platform.
    </td>
  </tr>
</table>

### Dispute documents

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`DisputeDocumentId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Dispute Document](/api-reference/dispute-documents/view-dispute-document)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Disputes](/guides/disputes)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_DOCUMENT_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute Document has been successfully added to the Dispute, either by the platform or Mangopay’s team.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_DOCUMENT_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute Document has been refused by Mangopay’s team.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_DOCUMENT_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute Document has been validated by Mangopay’s team.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`DISPUTE_DOCUMENT_VALIDATION_ASKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Dispute Document has been sent to Mangopay’s team for validation.
    </td>
  </tr>
</table>

### Repudiations

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`RepudiationId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Repudiation](/api-reference/repudiations/view-repudiation)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Disputes](/guides/disputes)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_REPUDIATION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      A chargeback has been filed and has been created in Mangopay's environment (Repudiation Wallet).
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_REPUDIATION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      A chargeback has been filed but the transaction from the Repudiation Wallet back to the initial pay-in author has failed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_REPUDIATION_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      A chargeback has been filed and successfully sent back to the initial pay-in author.
    </td>
  </tr>
</table>

### Settlement transfers

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`SettlementId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Settlement Transfer](/api-reference/dispute-settlement/view-settlement-transfer)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Disputes](/guides/disputes)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_SETTLEMENT_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Settlement Transfer has been created but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_SETTLEMENT_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Settlement Transfer could not be processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_SETTLEMENT_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Settlement Transfer has been successfully processed.
    </td>
  </tr>
</table>

## Transfers

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`TransferId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Transfer](/api-reference/transfers/view-transfer)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>

    <td class="table-content" />
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_NORMAL_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Transfer has been created but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_NORMAL_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Transfer could not be processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_NORMAL_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Transfer has been successfully processed.
    </td>
  </tr>
</table>

## FX conversions

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`ConversionId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Conversion](/api-reference/conversions/view-conversion)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Conversions](/guides/)</td>
  </tr>
</table>

### Instant conversions

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INSTANT_CONVERSION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Instant Conversion was initiated and its `Status` changed to `CREATED`, but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INSTANT_CONVERSION_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Instant Conversion was processed successfully and its `Status` changed to `SUCCEEDED`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INSTANT_CONVERSION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Instant Conversion could not be processed. See the `ResultCode` and `ResultMessage` for more information about the [error](/errors/codes#fx-conversions) that occurred.
    </td>
  </tr>
</table>

### Quoted conversions

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`QUOTED_CONVERSION_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Quoted Conversion was initiated and its `Status` changed to `CREATED`, but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`QUOTED_CONVERSION_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Quoted Conversion was processed successfully and its `Status` changed to `SUCCEEDED`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`QUOTED_CONVERSION_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Quoted Conversion could not be processed. See the `ResultCode` and `ResultMessage` for more information about the [error](/errors/codes#fx-conversions) that occurred.
    </td>
  </tr>
</table>

## Payouts

### Standard payouts

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`PayoutId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Payout](/api-reference/payouts/view-payout)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Payouts](/guides/payouts)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYOUT_NORMAL_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Payout transaction has been created but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYOUT_NORMAL_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Payout transaction has failed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYOUT_NORMAL_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Payout transaction has been successfully processed.
    </td>
  </tr>
</table>

### Instant payouts

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`PayoutId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Payout and check mode applied](/api-reference/payouts/view-payout-check-mode-applied)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Initiate an SCT Inst payout](/guides/payouts/integration#initiate-an-sct-inst-payout)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INSTANT_PAYOUT_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Instant Payout transaction has failed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INSTANT_PAYOUT_FALLBACKED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Payout could not be processed instantly; it will be processed in 48 hours as a standard payout instead.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INSTANT_PAYOUT_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Instant Payout transaction has been successfully processed.
    </td>
  </tr>
</table>

## Refunds

### Pay-in refunds

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`RefundId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Refund](/api-reference/refunds/view-refund)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Refunds - Pay-in](/guides/refunds#pay-in-refunds)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_REFUND_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The PayIn Refund transaction has been created but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_REFUND_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The PayIn Refund transaction could not be processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYIN_REFUND_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The PayIn Refund transaction has been successfully processed.
    </td>
  </tr>
</table>

### Transfer refunds

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`RefundId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Refund](/api-reference/refunds/view-refund)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Refunds - Transfer](/guides/refunds#transfer-refunds)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_REFUND_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Transfer Refund has been created but is not yet processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_REFUND_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Transfer Refund transaction could not be processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`TRANSFER_REFUND_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Transfer Refund transaction has been successfully processed.
    </td>
  </tr>
</table>

### Payout returns

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`RefundId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Refund](/api-reference/refunds/view-refund)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Payouts - Returns](/guides/payouts/rejects-returns)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYOUT_REFUND_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The payout return has been created.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYOUT_REFUND_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The payout return has failed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`PAYOUT_REFUND_SUCCEEDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The payout return has been successfully processed.
    </td>
  </tr>
</table>

## Echo

### Intents

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">Intent `CaptureId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View an Intent](/api-reference/intents/view-intent)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Echo](/guides/echo)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_AUTHORIZED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent was successfully created.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_CAPTURED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent Capture was successfully processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_REFUNDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent Refund was successfully processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_REFUND_REVERSED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent Refund was successfully reversed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_DISPUTE_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent Dispute was successfully processed.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_DISPUTE_DEFENDED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent Dispute `Status` was successfully changed to `DEFENDED`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_DISPUTE_WON`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent Dispute was successfully processed as `WON`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_DISPUTE_LOST`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent Dispute was successfully processed as `LOST`.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_SETTLED_NOT_PAID`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent was successfully reconciled.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`INTENT_PAID`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Intent was successfully paid.
    </td>
  </tr>
</table>

### Intent Splits

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">Intent `SplitId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View an Intent](/api-reference/intents/view-intent)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Echo](/guides/echo)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SPLIT_CREATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Split was successfully created.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SPLIT_PENDING_FUNDS_RECEPTION`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Split was successfully reconciled.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SPLIT_AVAILABLE`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Split was successfully paid.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SPLIT_REJECTED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Split could not be processed due to a technical issue, and can be retried.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`SPLIT_REVERSED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The Split was successfully reversed.
    </td>
  </tr>
</table>

## Reports

<table>
  <tr>
    <th class="header">Resource</th>
    <td class="table-content">`ReportingId`</td>
  </tr>

  <tr>
    <th class="header">Related GET</th>
    <td class="table-content">[GET View a Report](/api-reference/reporting/view-report)</td>
  </tr>

  <tr>
    <th class="header">Related guides</th>
    <td class="table-content">[Reports](/reports)</td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`REPORT_GENERATED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The report has been generated and is ready for download at the `DownloadURL` value.
    </td>
  </tr>
</table>

<table>
  <tr>
    <th class="header">Event type</th>
    <td class="table-content">`REPORT_FAILED`</td>
  </tr>

  <tr>
    <th class="header">Description</th>

    <td class="table-content">
      The report was not generated successfully.
    </td>
  </tr>
</table>