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

# Blocked users

export const Transfer = ({content}) => <Tooltip tip="A movement of funds from one wallet to another, within the Mangopay environment.">
        {content}
    </Tooltip>;

export const Platform = ({content}) => <Tooltip tip="App or website that integrates Mangopay to handle payments for its end users. ">
        {content}
    </Tooltip>;

export const PayIn = ({content}) => <Tooltip tip="A movement of funds arriving in the Mangopay environment to a wallet.">
        {content}
    </Tooltip>;

export const Payout = ({content}) => <Tooltip tip="A movement of funds leaving the Mangopay environment to the bank account of a user.">
        {content}
    </Tooltip>;

export const Issuer = ({content}) => <Tooltip tip="The bank or PSP of the user making a pay-in, from which Mangopay acquires the funds. ">
        {content}
    </Tooltip>;

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 <PayIn content="pay-ins" /> or send or receive <Transfer content="transfers" />.
* Outflows - When outflows are blocked, the user is no longer allowed to make <Payout content="payouts" /> or send or receive transfers.

<Note>
  **Note - Refund may be needed for blocked pay-ins**

  Pay-ins via <a href="/api-reference/bank-wire-payins/bank-wire-payin-object">bank wire</a> or to a <a href="/api-reference/virtual-accounts/external-instruction-bank-wire-payin-object">vIBAN</a> are refused even if already processed (i.e., funds already left the <Issuer content="issuing bank" />).

  As a consequence, funds must be reimbursed by the <Platform content="platform" />. To avoid such a situation, you can use the <a href="/api-reference/user-regulatory-status/view-user-regulatory-status">GET View a User Regulatory Status</a> endpoint prior to executing your pay-in.
</Note>

## Notifications

You can find out whether or not a user has been blocked by setting up <a href="/webhooks">webhook notifications</a>.

The endpoint <a href="/api-reference/user-regulatory-status/view-user-regulatory-status">GET View a User Regulatory Status</a> returns the `ScopeBlocked` parameter containing dedicated parameters for inflows and outflows, which are `true` if blocked.

The following <a href="/webhooks/event-types">event types</a> 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 <a href="/api-reference/user-regulatory-status/view-user-regulatory-status">GET View a User Regulatory Status</a> 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 <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.</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 <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.</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 <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.</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.

        <br />

        <br />

        For further inquiries, please contact our Support team <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.
      </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)).

        <br />

        <br />

        Once this has been completed, please contact our Support team <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.

        <br />

        <br />

        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.

        <br />

        <br />

        Once done, please contact our Support team <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.
      </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 <a href="/guides/users/verification/requirements/kyb-local">local KYB structures</a> for their kind of entity, then submit their verification documents.

        <br />

        <br />

        Once done, please contact our Support team <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.
      </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.

        <br />

        <br />

        Once done, please contact our Support team <a href="https://hub.mangopay.com/" target="_blank">via the Dashboard</a>.
      </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.

        <br />

        <br />

        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.

        <br />

        <br />

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