Skip to main content

Getting Started with Paddle Payment Integration

Configure Credentials​

  1. Open {workspace}/{vertical}/services_config/nn_env.json.

  2. Set JWT_SECRET to a unique value.

  3. Create an OAuth 2.0 Client ID (Web application) in the Google Cloud Console.

  4. Add credentials and admin email to nn_env.json:

    {
      "JWT_ALGORITHM": "HS256",
      "JWT_SECRET": "your-unique-secret",
      "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
      "GOOGLE_CLIENT_SECRET": "your-client-secret",
      "admin_emails": "your-email@example.com"
    }

Deploy Services​

  1. In the UX, deploy the Auth service.

  2. In the UX, deploy the Subscription and Billing service.

  3. Copy the auth service URL from the deploy output.

  4. In Google Cloud Console, add the Authorized redirect URI:

    https://<auth-service-url>/oauth/loggedin

Deploy UI and Configure Paddle​

  1. In the UX, deploy the UI.

  2. Open your site and log in. You should see the Admin link in the nav bar.

  3. Go to Admin > Manage Products > Credentials tab.

  4. Enter your Paddle credentials:

    • API Key — from the Paddle dashboard (Developer Tools > Authentication)
    • Client Token — from Paddle (used for frontend checkout)
    • Webhook Secret — from Paddle (Developer Tools > Notifications)

  5. In Paddle, set the webhook URL to your Subscription and Billing service endpoint:

    https://sbcs.us-east-1.{site}.{vertical}.narambu.com/webhook

  6. Use the Environment dropdown to configure Sandbox or Live separately.

Sync Product Catalog​

  1. Go to the Sync tab and sync your product catalog from Paddle.
  2. Go to the Classify tab to select which products are shown to users.
  • Environment Variables — Services receive region, site, bucket names, and service URLs automatically. Custom variables go in nn_env.json.
  • Auth Service — more on Google OAuth configuration