First draft built with codex #1350
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| curl -X POST \ | ||
| https://api.revenuecat.com/v1/receipts \ | ||
| -H 'Content-Type: application/json' \ | ||
| -H 'X-Platform: paypal' \ | ||
| -H 'Authorization: Bearer YOUR_REVENUECAT_PAYPAL_APP_PUBLIC_API_KEY' \ | ||
| -d '{ "app_user_id": "my_app_user_id", | ||
| "fetch_token": "I-XXXXXXXXXXXX" | ||
| }' |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,22 @@ | ||
| --- | ||
| title: PayPal Product Setup | ||
| slug: paypal-products | ||
| excerpt: Setting up products and plans in the PayPal Dashboard | ||
| hidden: false | ||
| --- | ||
|
|
||
| To set up products for PayPal, start by logging into the PayPal Developer Dashboard. This guide assumes basic knowledge of PayPal's subscription products and plans. For more information, visit PayPal's [documentation](https://developer.paypal.com/docs/subscriptions/). | ||
|
|
||
| ## Create a product and plan | ||
|
|
||
| 1. In the PayPal Developer Dashboard, create a Product for your subscription. | ||
| 2. Create one or more Plans under that Product (monthly, yearly, etc.). | ||
| 3. Copy the Plan ID for each plan you want to track in RevenueCat. | ||
|
|
||
| :::info Product Mapping between RevenueCat and PayPal | ||
| A PayPal Plan maps to a Product in RevenueCat. If you create multiple plans under a single PayPal product, you'll import each plan into RevenueCat as a separate product. | ||
| ::: | ||
|
|
||
| ## Integrate with RevenueCat | ||
|
|
||
| If you're ready to integrate your new PayPal plans with RevenueCat, continue our [product setup guide →](/getting-started/entitlements). | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,87 @@ | ||
| --- | ||
| title: PayPal | ||
| slug: paypal | ||
| excerpt: Track PayPal revenue in RevenueCat | ||
| hidden: false | ||
| --- | ||
|
|
||
| RevenueCat supports PayPal for tracking revenue from purchases that happen outside RevenueCat. This lets you unlock entitlements and report PayPal revenue in RevenueCat. | ||
|
|
||
| :::info Invite-only beta feature | ||
| This integration is currently in beta, and available by invite only. If you're interested in tracking PayPal purchases within RevenueCat, [let us know](https://form.typeform.com/to/A4Nfn0aI). | ||
| ::: | ||
|
|
||
| :::info External purchase tracking only | ||
| This integration allows you to import purchases taking place in PayPal. It does not add payment method support to RevenueCat Web Billing, Web SDK, Web Purchase Links, or Paywalls, which we're looking to support in the future. | ||
| ::: | ||
|
|
||
| ## Supported features | ||
|
|
||
| - Import and sync PayPal purchases created in your own checkout or backend. | ||
| - Automatic tracking via PayPal webhooks (server-to-server notifications). | ||
| - Manual tracking via the RevenueCat POST receipt endpoint. | ||
|
|
||
| ### Current limitations | ||
|
|
||
| - Only one product per purchase is supported (single item per order or subscription). | ||
|
Contributor
There was a problem hiding this comment. another current limitations:
|
||
|
|
||
| ## 1. Create PayPal products and plans | ||
|
|
||
| Create subscription Products and Plans in PayPal. You will import the PayPal **Plan ID** into RevenueCat as the product identifier. | ||
|
|
||
| For detailed steps, see [PayPal Product Setup](/getting-started/entitlements/paypal-products). | ||
|
|
||
| ## 2. Add a PayPal configuration in RevenueCat | ||
|
|
||
| 1. Log into your RevenueCat account | ||
| 2. Go to your project | ||
| 3. Go to **Apps & providers** | ||
| 4. Add a new web configuration | ||
| 5. Select the PayPal provider | ||
| 6. Enter your **Client ID** and **Client Secret** from the PayPal Developer Dashboard | ||
| 7. Set whether this is **Sandbox** or **Production** | ||
|
|
||
| :::info Sandbox and production are separate | ||
| PayPal sandbox and production environments use different credentials. Create separate RevenueCat configurations for each environment. | ||
| ::: | ||
|
|
||
| ## 3. Configure purchase tracking | ||
|
|
||
| To automatically track PayPal purchases, enable **Track new purchases from server-to-server notifications** in the PayPal configuration. RevenueCat will create and manage the required PayPal webhook for you. | ||
|
|
||
| ### App User ID detection methods | ||
|
|
||
| RevenueCat can associate PayPal purchases with an App User ID in two ways: | ||
|
|
||
| 1. **Use anonymous App User IDs**: RevenueCat will create an anonymous App User ID for each purchase. | ||
| 2. **Use PayPal custom_id**: Set PayPal's `custom_id` to the RevenueCat App User ID when you create the subscription or order. RevenueCat will read `custom_id` from webhook events and use it as the App User ID. | ||
|
|
||
| If `custom_id` is missing, the purchase will be associated with an anonymous App User ID. | ||
|
|
||
| ## 4. Import PayPal plans into RevenueCat | ||
|
|
||
| 1. Go to **Product catalog → Products** in the RevenueCat dashboard | ||
| 2. Find your PayPal configuration and click **Import** | ||
| 3. Select the PayPal plans you want to use and click **Import** | ||
|
|
||
| ## 5. Create entitlements in RevenueCat | ||
|
|
||
| Follow the [entitlements guide](/getting-started/entitlements) to attach your PayPal products to entitlements. | ||
|
|
||
| ## 6. Send PayPal tokens to RevenueCat (manual) | ||
|
|
||
| If you are not using webhook-based tracking, you can send PayPal purchases to RevenueCat through the [POST receipt endpoint](/migrating-to-revenuecat/migrating-existing-subscriptions/receipt-imports). | ||
|
|
||
| The only required fields when sending your PayPal purchase to the RevenueCat API are the following: | ||
|
|
||
| - `fetch_token`: Your PayPal subscription ID (starts with `I-`) or a PayPal order/capture ID for one-time purchases. | ||
| - `app_user_id`: The App User ID that the purchase should be applied to. | ||
|
|
||
| **Headers** | ||
|
|
||
| - `X-Platform`: Should be set to `paypal`. | ||
| - `Authorization`: It should be `Bearer YOUR_REVENUECAT_PAYPAL_APP_PUBLIC_API_KEY` | ||
|
|
||
| import curlContent from "@site/code_blocks/getting-started/paypal_1.curl?raw"; | ||
|
|
||
| <RCCodeBlock tabs={[{ type: "curl", content: curlContent }]} /> | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Shouldn't we mention the auto-import products functionality? That way, they don't have to copy the plan ID at all, right?