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

# 201002

<table>
  <tbody>
    <tr>
      <th class="header">
        Error message
      </th>

      <td class="table-content">
        PayPal related payment instrument declined
      </td>
    </tr>

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

      <td class="table-content">
        PayPal related payment instrument declined.
      </td>
    </tr>

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

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

#### Causes

This error may occur when the funding source fails, for example:

* The payment is declined by the bank of the end user.
* The payment method is not allowed (e.g., the user used a prepaid debit card).

#### Example

**`API Response`**

```json API Response
{
    "Id":"123589647",
    "Tag":"custom meta",
    "CreationDate":1677679492,
    "AuthorId":"20963965478",
    "CreditedUserId":"20963965478",
    "DebitedFunds":{
        "Currency":"EUR",
        "Amount":7708
    },
    "CreditedFunds":{
        "Currency":"EUR",
        "Amount":7708
    },
    "Fees":{
        "Currency":"EUR",
        "Amount":0
    },
    "Status":"FAILED",
    "ResultCode":"201002",
    "ResultMessage":"PayPal related payment instrument declined",
    "ExecutionDate":null,
    "Type":"PAYIN",
    "Nature":"REGULAR",
    "CreditedWalletId":"20456987",
    "DebitedWalletId":null,
    "PaymentType":"PAYPAL",
    "ExecutionType":"WEB",
    "RedirectURL":"https://www.sandbox.paypal.com/checkoutnow?token=70L956685P053742U",
    "ReturnURL":"http://www.my-site.com/returnURL/?transactionId=163292678",
    "Culture":"FR",
    "ShippingAddress": {
        "RecipientName": "John Doe",
        "Address": {
            "AddressLine1": "The Oasis",
            "AddressLine2": "Rue des Plantes",
            "City": "Paris",
            "Region": "Ile de France",
            "PostalCode": "75001",
            "Country": "FR"
        }
    },
    "PaypalBuyerAccountEmail":null,
    "StatementDescriptor":"nov2022"
}
```