> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://ixopay.ferndocs.com/user-manual/adapters/pay-pal/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://ixopay.ferndocs.com/_mcp/server.

# PayPal

## PayPal Creditcard

Configure the following parameters for the Connector (see Connector Detail Overview - PayPal - Vault Configuration):

1. Select the mandatory **Environment** : Live, Sandbox
2. Fill in the mandatory **Client ID**
3. Fill in the mandatory **Secret**
4. Fill in the mandatory **Merchant Email Address**
5. Fill in the mandatory **Merchant PayPal Account ID**

For the PayPal-specifc Parameters see also [https://developer.paypal.com/api/rest/](https://developer.paypal.com/api/rest/)

![Connector Detail Overview - PayPal - Vault Configuration](https://documentation.ixopay.com/manual/assets/ideal-img/connector-detail-overview-paypal-vault-configuration.82e490e.1280.png)Connector Detail Overview - PayPal - Vault Configuration

## PayPal Express

Configure the following parameters for the Connector (see Connector Config PayPal Express):

1. Fill in the mandatory **PayPal API Username**
2. Fill in the mandatory **PayPal API Password**
3. Fill in the mandatory **Extra Data: signature**
4. Fill in the mandatory **Extra Data: receiveEmail**
5. Fill in the optional **Extra Data: apiEndpoint**
6. Fill in the optional **Extra Data: paymentUrl**
7. Fill in the optional **Extra Data: buttonSource**
8. Select the optional **Extra Data: treatDisputeAsChargeback:** True, False — Setting to create a chargeback transaction for a PayPal Dispute
9. Select the optional **Extra Data: IgnoreDisputes:** True. False — Setting to ignore PayPal Disputes
10. Select the optional **Extra Data: disablePostbackValidation:** True, False — Setting to not validate the signature PayPal is sending
11. Select he optional **Extra Data: omitItems:** True, False — Setting to not include items from the Transaction to PayPal
12. Select the optional **Extra Data: billingAgreementType:** MerchantInitiatedBilling (Default), MerchantInitiatedBillingSingleAgreement — Setting to define the type of billing agreement created in PayPal
13. Select the optional **Extra Data: limitPaymentType:** InstantOnly (default), no — Setting to only allow Instant payments, this will disable eVoucher payments (asynchronous payments)
14. Select the optional **Extra Data: paymentActionForPreauthorize:** Authorization, Order, Order + Authorization, Sale — Setting to define which flow is used on PayPal side for Preauthorize transaction
15. Select the optional **Extra Data: returnPayPalCustomerData:** True, False — Setting to include the Customer Data available in PayPal to be included in the response
16. Select the optional **Extra Data: paypalFeeMapping:** Provider Fees, Markup Fees — Setting to determine under which Fee Entity the PayPal Fees should be mapped, either Provider Normal Fee or Provider Markup Fee

![Connector Config PayPal Express](https://documentation.ixopay.com/manual/assets/ideal-img/connector-config-paypal-express.4608518.1280.png)Connector Config PayPal Express

## Data Fetcher Configuration

You have the option to configure Data Fetchers (see section [Enable and Set Up Reconciliation on the Provider Level](https://documentation.ixopay.com/manual/docs/post-processing/provider)) either on Provider or on Connector Level, depending on which setup works better for your provider.

### Reconciliation

Configure the following Parameters for the Reconciliation Data Fetcher to fetch Reconciliation via SFTP (see Reconciliation Data Fetcher Provider Level):

1. Fill in an optional **Name**
2. Fill in the expected **Interval** in which the Reconciliation File should be fetched - days, hours
3. Select the Adapter **Paypal**
4. Enable **Testmode**
5. Fill in the mandatory **Extra Data:** **sftpUsername** used for authentication
6. Fill in the mandatory **Extra Data: sftpPassword** : used for authentication
7. Select in the optional **Extra Data:** **mapFeesTo** - Normal Provider Fees, Provider Markup
8. Select in the optional **Extra Data:** **handleTemporaryHolds** - True, False; If set to true, temporary holds are handled as chargebacks inIXOPAY platform
9. Select in the optional **Extra Data:** **useReferenceMerchantTxID** - True, False; If set to true, instead of autogenerated transaction IDs, the reference merchant tx ID is used as UUID for created transactions via reconciliation.

![Reconciliation Data Fetcher Provider Level](https://documentation.ixopay.com/manual/assets/ideal-img/reconciliation-data-fetcher-provider-level.07206a7.928.png)Reconciliation Data Fetcher Provider Level