Primer’s direct integration to PayPal enables you to accept payments across Web, iOS & Android, and vault PayPal billing agreements.

​
Get started with PayPal

​
Before you begin

If this is your first payment method, make sure to follow the Get started guide to begin processing payments with Primer.

​
Configure in the Dashboard

  1. Add PayPal payment method to your Dashboard
Go to the integrations section of the Dashboard,click on the ‘New Integration’ button and search for PayPal. Follow the instructions to connect your PayPal processor account to your Primer Dashboard. When configuring your PayPal connection in Primer, you can choose the customer landing page during checkout. This setting determines whether customers are directed to the Billing page, where they can enter card details directly, or the Login page, where they are prompted to log in to their PayPal account. Select the option that best aligns with your desired customer experience.
  1. Activate PayPal on the Checkout
Go to the Checkout section of the Dashboard and activate the PayPal payment method. Then go to the settings view of PayPal, and make sure that PayPal is properly set up to use your PayPal processor account.
  1. Configure a Workflow to process payments made with PayPal
Go to the Workflow make sure your PayPal processor is used to process payments made with PayPal.

​
Prepare the client session

PayPal leverages the following parameters to process a payment. Pass them when creating the client session.
Parameter NameRequiredDescription
currencyCode✓3-letter currency code in ISO 4217 format, e.g. USD for US dollars
order
↳ lineItems		✓Details of the line items of the order
order
↳ countryCode		✓The country code of the user is required for PayPal.
metadata
↳ paypal_custom_id		Primer’s direct integration to PayPal enables you send a custom ID to PayPal to link your orders to a specific custom ID.
metadata
↳ paypal_invoice_id		Primer’s direct integration to PayPal enables you send a Invoice ID to PayPal to link your orders to a specific invoice ID.
metadata
↳ paypal_client_metadata_id		✓Required field if the Billing Agreement is being created.

​
Add PayPal into your website or mobile app

Drop-in UI

Use our customizable drop-in UI to quickly add payment methods to your checkout.

Headless Checkout

Have the freedom to build your own UI using our headless checkout.