Sign-up
PayPal provides a self-service sign-up for a sandbox account. To sign-up for an account visit the sign-up page and fill in the details, ensuring to chooseBusiness Account when prompted.
Credentials
When setting up PayPal in the dashboard, configure the following credentials, which are obtained from PayPal:Client ID
The PayPal Client ID can be found in the PayPal Developer Portal under theApps & Credentials -> REST API Apps -> Your App section.
Client secret
The PayPal Client Secret can also be found in the PayPal Developer Portal under theApps & Credentials -> REST API Apps -> Your App section.
Webhook ID
The PayPal Webhook ID can be set once you’ve configured the app and added a webhook. In the PayPal Merchant Dashboard create a webhook to the system with the URL provided after the connector is set up. Once set up, you are given a webhook ID by PayPal, which is required for verifying that the incoming webhooks are authentic and sent by PayPal.BN code
The BN Code is an optional field that identifies the integration partner to PayPal. By default this is set to the BN code but if you are already an integration partner then you can set this to your own value.Merchant ID
The PayPal Merchant ID can be found in the PayPal Merchant Dashboard underAccount settings -> Business Information.
Ingest billing details / Ingest shipping details
By default, billing, and shipping details received from PayPal are not imported. To enable this feature, head over to Connections -> Configured and select your PayPal connector. Next, go to Credentials and toggle Import billing details and/or Import shipping details. When Import billing details is enabled, any of the user’s name, email address, and billing address are automatically imported into your transaction, merging it with any data already present on the transaction. Linked buyers are not updated, but only the snapshot of the buyer on the transaction. When Import shipping details is enabled, the user’s shipping address is automatically requested and imported into your transaction, merging it with any data already present on the transaction. Linked buyers are not updated, but only the snapshot of the buyer on the transaction. Please note that the ingestion of billing and shipping details is not available for tokenized payments.PayPal account configuration
Payment receiving preferences
By default, PayPal only settles payments automatically if the payment is in the primary currency of the PayPal merchant account. If you need to accept payments in additional currencies, you need to open a PayPal account balance in each of the currencies you intend to accept. Alternatively, you can configure your PayPal merchant account to automatically convert payments into the primary currency. If you receive a payment in a currency that your PayPal merchant account is not configured to accept, the payment enters a pending state and you need to log-in to the PayPal merchant dashboard to trigger settlement, either by opening the required currency balance, or converting the payment into the primary currency of your PayPal account. Please note that payments left in a pending state are eventually reversed by PayPal.Vault
To allow customers to tokenize their PayPal account for future payments, you need to contact PayPal and request that your account be enabled for Vault. Once Vault has been enabled on your PayPal merchant account, you can toggle the tokenization feature on within the PayPal connector settings in the dashboard.