Connect the Paddle customer portal with AI
Add a billing-management button that opens a fresh hosted Paddle portal for the signed-in customer. Keep the account lookup and session creation on your server.
Connect the Paddle customer portal with AI when users need a place to manage invoices or payment methods without a custom billing interface. The paddle-customer-portal skill guides a Next.js server action that authenticates the visitor, resolves their Paddle customer ID and requests a short-lived session. The application returns only the destination needed for that click.
The overview suits a general billing button. A targeted subscription link suits an account page where the customer has already picked a subscription. In that case, check ownership before requesting the link. Someone who has signed up but never purchased needs a clear empty state.
What it does
- Add hosted self-service billing to an existing account area.
- Open the overview for the signed-in customer.
- Request an appropriate link for an owned subscription.
- Handle an account that has no Paddle customer record yet.
- Avoid caching portal sessions in your application.
Install and use
- Install the skill in a coding agent. Use Next.js, the official Paddle Node SDK, authenticated sessions, a customer mapping and a server key with portal-session write permission. The example uses Supabase.
- Ask, “Add a Manage billing button that looks up our signed-in customer on the server and creates a new portal session per click.”
- Check the result with separate sandbox accounts. Keep live session links out of logs and shared messages.
FAQ
Source
Made by Paddle. Original skill: paddle-customer-portal, published on GitHub under the Apache-2.0 licence.
View on GitHub