How to Connect RevenueStack to Paddle

Before you start

You need access to the current Paddle Billing dashboard and the seller account whose catalog and prices RevenueStack will manage.

• Paddle Billing API keys are created under Developer tools → Authentication.
• Sandbox and live environments use different keys and API base URLs.
• Paddle API keys are server-side secrets; client-side tokens are a different credential type for Paddle.js.

1. Paddle Vendor / Account ID

RevenueStack uses your Paddle seller or account identifier to select the correct Paddle account. Paddle’s current API documentation calls account entities and resources by Paddle IDs; the exact dashboard label may be Seller ID or Account ID depending on your account view.

1. Sign in to the Paddle Billing dashboard and switch to the correct live or sandbox environment.
2. Open the account or business settings area and locate the seller/account identifier shown for that environment.
3. Copy the complete identifier without labels, spaces, or quotation marks.
4. If the dashboard does not expose the identifier in settings, use the account information shown in the current Paddle developer dashboard or ask the account owner to confirm the value before connecting.

acct_example_only

2. Paddle API Key (v2)

Paddle API keys authenticate requests to the Paddle Billing API with a Bearer token. New keys begin with a pdl_ prefix and identify sandbox or live mode.

1. In Paddle, open Developer tools → Authentication.
2. Select the API keys tab and choose New API key.
3. Give the key a clear name and description so the owner and purpose are recognizable.
4. Select only the permissions needed for RevenueStack’s catalog, pricing, subscription, and deployment workflow. Use the current Permissions documentation to review each scope.
5. Set an expiry date and enable rotation when your team can support key rotation.
6. Save the key and copy it immediately; Paddle displays the secret only once.
7. Paste the complete key into Paddle API Key in the authenticated RevenueStack application.

pdl_live_apikey_••••••••••••••••••••••••••••••••

Connect Paddle to RevenueStack

Provide the seller/account identifier and the API key for the same Paddle environment.

1. Paste the Vendor / Account ID into the account field.
2. Paste the complete pdl_live_ or pdl_sdbx_ API key into the API key field.
3. Save or test the connection.
4. Run a read-only catalog check before approving any deployment.