> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# Blocked users

As part of Mangopay's aim to guarantee the integrity of transactions conducted using its services, and in accordance with relevant regulations, Mangopay teams may block users.

Blocking involves the restriction of payment services to a specific user for reasons of suspected fraudulent behavior or compliance risk.

## Scope

The scope of the blocking of a user may be one or both of the following:

* Inflows - When inflows are blocked, the user is no longer allowed to make

  pay-ins

  or send or receive

  transfers

  .
* Outflows - When outflows are blocked, the user is no longer allowed to make

  payouts

  or send or receive transfers.

> **Note**
>
> **Note - Refund may be needed for blocked pay-ins**
>
> Pay-ins via [bank wire](/api-reference/bank-wire-payins/bank-wire-payin-object) or to a [vIBAN](/api-reference/virtual-accounts/external-instruction-bank-wire-payin-object) are refused even if already processed (i.e., funds already left the
>
> issuing bank
>
> ).
>
> As a consequence, funds must be reimbursed by the
>
> platform
>
> . To avoid such a situation, you can use the [GET View the Regulatory Status of a User](/api-reference/user-regulatory-status/view-user-regulatory-status) endpoint prior to executing your pay-in.

## Notifications

You can find out whether or not a user has been blocked by setting up [webhook notifications](/webhooks).

The endpoint [GET View the Regulatory Status of a User](/api-reference/user-regulatory-status/view-user-regulatory-status) returns the `ScopeBlocked` parameter containing dedicated parameters for inflows and outflows, which are `true` if blocked.

The following [event types](/webhooks/event-types) are available to set up hooks:

* `USER_INFLOWS_BLOCKED`
* `USER_INFLOWS_UNBLOCKED`
* `USER_OUTFLOWS_BLOCKED`
* `USER_OUTFLOWS_UNBLOCKED`

## Steps to unblocking

Once you know a user is blocked, you can take action to unblock the user.

The [GET View the Regulatory Status of a User](/api-reference/user-regulatory-status/view-user-regulatory-status) endpoint returns an `ActionCode`. The table below describes the possible action codes and the actions you can take.

### Action codes

<table class="hx-inside">
  <thead>
    <tr>
      <th class="header">
        Action code
      </th>

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

      <th class="header">
        Action to take
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td class="table-content">
        #### 008701
      </td>

      <td class="table-content">
        The user has been blocked because of suspected fraudulent behavior.
      </td>

      <td class="table-content">
        Please contact our Support team 

        [via the Dashboard](https://hub.mangopay.com/)

        .
      </td>
    </tr>

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

      <td class="table-content">
        The user has been blocked because of a compliance issue.
      </td>

      <td class="table-content">
        Please contact our Support team [via the Dashboard](https://hub.mangopay.com/).
      </td>
    </tr>

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

      <td class="table-content">
        The user has been blocked by one of our teams due to a more general issue.
      </td>

      <td class="table-content">
        Please contact our Support team [via the Dashboard](https://hub.mangopay.com/).
      </td>
    </tr>

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

      <td class="table-content">
        The user asked for their data to be deleted. Part of that process is to block the user.
      </td>

      <td class="table-content">
        Please contact our data protection officer via email to [dpo.mangopay@mangopay.com](mailto:dpo.mangopay@mangopay.com).
      </td>
    </tr>

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

      <td class="table-content">
        The document is suspected to be fraudulent. The account will remain blocked until reception of a valid identity proof document (with a better visual quality or a different kind of proof).
      </td>

      <td class="table-content">
        Please submit a new identity proof document, if possible a different one.

        \


        \


        For further inquiries, please contact our Support team [via the Dashboard](https://hub.mangopay.com/).
      </td>
    </tr>

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

      <td class="table-content">
        The user has been identified as a potential politically exposed person (PEP).
      </td>

      <td class="table-content">
        The user needs to complete the Mangopay Declaration Regarding Politically Exposed Persons ([English](https://mangopay.com/terms/PEP/PEP_form_EN.pdf) / [French](https://mangopay.com/terms/PEP/PEP_form_FR.pdf) / [Spanish](https://mangopay.com/terms/PEP/PEP_form_ES.pdf)).

        \


        \


        Once this has been completed, please contact our Support team [via the Dashboard](https://hub.mangopay.com/).

        \


        \


        The individual (natural user or legal representative) will also need to provide proof of identity via the API unless one has already been provided and validated.
      </td>
    </tr>

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

      <td class="table-content">
        The user needs to upload a new proof of identity. For a Legal User, please upload a registration proof in addition to the proof of identity.
      </td>

      <td class="table-content">
        Please upload a proof of identity and a proof of registration (Legal User only) through the dashboard.

        \


        \


        Once done, please contact our Support team [via the Dashboard](https://hub.mangopay.com/).
      </td>
    </tr>

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

      <td class="table-content">
        The user needs to modify their legal personality type and submit the correct verification documents.
      </td>

      <td class="table-content">
        Please change the Legal User's `LegalPersonType` to the one specified in the [local KYB structures](/guides/users/verification/requirements/kyb-local) for their kind of entity, then submit their verification documents.

        \


        \


        Once done, please contact our Support team [via the Dashboard](https://hub.mangopay.com/).
      </td>
    </tr>

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

      <td class="table-content">
        A proof of address is required.
      </td>

      <td class="table-content">
        Please upload a proof of address through the dashboard.

        \


        \


        Once done, please contact our Support team [via the Dashboard](https://hub.mangopay.com/).
      </td>
    </tr>

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

      <td class="table-content">
        The user needs to complete KYC/KYB verification.
      </td>

      <td class="table-content">
        The User must complete [KYC/KYB verification](/guides/users/verification) by providing the required information and documents, either via the [hosted KYC/KYB solution](/guides/users/verification/hosted) or the API-only solution.

        \


        \


        The user is unblocked automatically once they obtain the `KYCLevel` of `REGULAR` by successfully completing the KYC/KYB verification process, provided they are not blocked for another reason.

        \


        \


        If the user is not automatically unblocked after being KYC/KYB verified, please check the [GET View the Regulatory Status of a User](/api-reference/user-regulatory-status/view-user-regulatory-status) endpoint and if no `ActionCode` is returned then contact Support [via the Dashboard](https://hub.mangopay.com/).
      </td>
    </tr>

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

      <td class="table-content">
        Additional documents or information are required for the user's KYC/KYB verification.
      </td>

      <td class="table-content">
        The user needs to submit the additional documents via the legacy [KYC Document](/api-reference/kyc-documents/kyc-document-object) endpoints. See [sending additional documents](/guides/users/verification/hosted#sending-additional-documents) for details.
      </td>
    </tr>
  </tbody>
</table>