PayPal Integration
Integrating PayPal with Sphere enables seamless ingestion of transaction data for PayPal Checkout sales, payment reversals, and payment refunds.
This guide provides step-by-step instructions on generating an API key in PayPal and linking it to Sphere for a secure integration.
Sphere does not currently support a direct live tax calculation integration with PayPal. Instead, we recommend using the Sphere Tax Calc API to calculate tax for your PayPal transactions. Follow the instructions below to link customer address information between your Sphere Tax Calc API requests and your PayPal transactions.
Note: If you are connecting to a PayPal sandbox environment, you must use a corresponding Sphere test organization.
Part 1: Configure Data Synchronization from PayPal to Sphere
In the Sphere account, click on the Connect button on the PayPal tile.
Create a PayPal App
In the PayPal Developer Console, navigate to Apps & Credentials in the sidebar.
Click Create App and enter a unique name to identify the Sphere integration.
After creating the app, PayPal will display the App Details, including the Client ID and Client Secret.
Connect PayPal to Sphere
Return to your Sphere account.
Enter the Client ID and Client Secret from the PayPal app you created above.
Currently, we only support a single product for your PayPal transactions. Select the product you'd like to associate with your PayPal transactions from the dropdown.
Click Connect to complete the data synchronization setup.
Part 2: Configure Sphere Tax API for Tax Calculation
Please follow the guide here to use the Sphere Tax API to calculate the tax to apply to your PayPal transactions.
To link customer address information to your PayPal transactions, we need a shared customer identifier across both your Sphere Tax API requests and your PayPal transactions. Please add your internal customer identifier to the custom_id field in your PayPal checkout requests and to the customer_id field in your Sphere Tax API requests.
Last updated