Integrate PayPal with Icodrip using API credentials and webhooks for payment tracking.
To connect PayPal, you need a PayPal Business account. Personal accounts do not support the API access required for webhook integration. If you are currently on a personal account, upgrade to a business account in your PayPal settings.
You will also need to create an app in the PayPal Developer portal to get your API credentials. Go to developer.paypal.com, sign in with your PayPal business account, and navigate to Apps & Credentials.
Decide whether you want to start in sandbox mode (for testing) or go directly to live. We recommend setting up the sandbox first to verify everything works, then switching to live credentials when ready.
In the PayPal Developer portal, create a new REST API app. Give it a descriptive name like "Icodrip Integration." PayPal will generate a Client ID and Secret for your app. Copy both values.
In your Icodrip dashboard, go to Settings > Integrations > Connect PayPal. Enter your PayPal Client ID and Client Secret. Select whether these are sandbox or production credentials. Icodrip validates the credentials by authenticating with the PayPal API.
Your credentials are encrypted at rest and never exposed in client-side code. You can rotate them at any time by generating new credentials in the PayPal Developer portal and updating them in Icodrip.
Icodrip needs to receive payment notifications from PayPal to track conversions. Copy the webhook URL from the Icodrip integration page and add it to your PayPal app's webhook configuration.
In the PayPal Developer portal, select your app, scroll to the Webhooks section, and add a new webhook. Paste the Icodrip URL and select the following event types: PAYMENT.SALE.COMPLETED, PAYMENT.SALE.REFUNDED, BILLING.SUBSCRIPTION.CREATED, and BILLING.SUBSCRIPTION.CANCELLED.
PayPal verifies webhook authenticity using a webhook ID and transmission signature. Icodrip stores your webhook ID and uses PayPal's verification API to validate every incoming event before processing it.
Test the integration by processing a payment in sandbox mode. Use one of PayPal's sandbox buyer accounts to make a purchase. The payment event should arrive at Icodrip within a few seconds and create a conversion record.
Check the conversion details in your dashboard to verify the amounts are correct. PayPal sends amounts in the transaction currency, and Icodrip uses these values directly for commission calculation. If you sell in multiple currencies, commissions are calculated in the transaction currency.
Once sandbox testing is complete, switch to live credentials in both PayPal and Icodrip. The webhook URL remains the same — only the API credentials change. Your first live conversion should appear within seconds of a real payment being processed.