Skip to main content

​
Overview

Paymint streamlines the process of integrating subscription billing into your app. By handling complex tasks like webhook management and API abstraction, you can focus on building your product.
Before you begin, you’ll need a Paddle account. Paddle is the payment processor that powers Paymint.

​
What You Need to Do

Complete these steps in the Paymint dashboard:
1

Set Up Paddle

Connect your Paddle account by providing your Paddle API key. This enables Paymint to interact with Paddle on your behalf.

Paddle Setup Guide

Complete the Paddle setup checklist and connect your account
What you’ll do:
  • Create or link your Paddle account
  • Follow the first 4 steps of the Paddle Setup Checklist
  • (Optional) Use Paymint’s UI to create products and prices if not already set up in Paddle
  • Enter your Paddle Secret API key in the Paymint dashboard
2

Generate API Keys

Create your Paymint API keys to authenticate your application with our SDK.

API Keys Setup

Create and manage your Paymint API keys
What you’ll do:
  • Generate a new API key for your environment (sandbox or production)
  • Store the key securely in your environment variables
  • Test the key with a sample API call
3

Integrate the SDK

Add the Paymint SDK to your application and start accepting payments.

Integration Guide

Code examples and integration walkthrough
What you’ll do:
  • Install @paymint/nextjs in your project
  • Set up the API route and provider
  • Build your pricing page

​
What Paymint Handles Automatically

Once connected, Paymint takes care of the heavy lifting:
FeatureDescription
Product SyncYour Paddle products and prices are automatically synced and kept up-to-date
Webhook ProcessingSubscription events (created, canceled, updated) are processed in real-time
Customer ManagementCustomer records are matched and managed automatically
Secure AuthenticationAPI key validation and session security are handled by the SDK
Paddle Token GenerationClient-side checkout tokens are securely generated server-side

​
Environment Variables

After completing setup, you’ll have these environment variables: 
# Your Paymint API key (from Step 2)
PAYMINT_API_KEY=paymint_test_xxxxx  # or paymint_live_xxx for production
The SDK auto-detects sandbox vs production based on your API key prefix. No additional configuration needed!

​
Next Steps

Integration Example

See a complete end-to-end integration with code examples

Next.js SDK Reference

Full API reference for hooks and server utilities