Become a Paddle partner
Join the Paddle partner program to read this content. You'll also get access to our partner API and agent tooling. Let us know a few details about your business to get started. Already a partner? Log in to view this page.
Magic sessions let partners send a user straight into the Paddle dashboard from their own platform, without the user entering Paddle credentials. Use them for tasks that are better handled in Paddle's UI than rebuilt in yours, such as final KYB document review or payout-method configuration.
A magic session starts as a one-time-use code. You create the code using the user API key, then either:
- Redirect the user's browser to the dashboard using the code.
- Exchange the code for a session token to authenticate API requests on the user's behalf.
Magic session entities hold information like:
- A one-time-use
codethat initiates a dashboard login. - A session
tokenthat works as a bearer token for authenticated requests, valid for one hour.
Codes are one-time-use and expire shortly after creation. Redirects only work from domains on Paddle's allowlist.