Skip to main content

​
Overview

Paymint API keys authenticate your application with the Paymint SDK. You need at least one API key to use Paymint in your project.
Before creating API keys, make sure you’ve connected your Paddle account first.

​
Creating an API Key

1

Navigate to API Keys

In the Paymint dashboard, go to Settings → API Keys.
2

Create a New Key

Click New API key and fill in:
  • Name — A descriptive name (e.g., “Production App”, “Dev Server”)
  • Environment — Sandbox or Production
  • Description (optional) — Notes about what this key is used for
3

Copy Your Key

Your full API key is shown only once. Copy it immediately and store it securely.
You won’t be able to see the full key again after this step. If you lose it, you’ll need to create a new one.

​
Security Best Practices

Follow these practices to keep your API keys secure:
PracticeDetails
Use environment variablesStore keys in .env files, never hardcode them
Separate environmentsUse different keys for sandbox and production
Rotate regularlyGenerate new keys periodically and revoke old ones
Never expose client-sideAPI keys are for server-side use only
Add to .gitignoreEnsure .env.local and .env are gitignored

​
Example .env.local

# Paymint API Key (server-side only)
PAYMINT_API_KEY=paymint_test_xxxxx
The SDK auto-detects sandbox vs production based on your API key prefix. No additional configuration needed!

​
Key Environments

EnvironmentKey PrefixUse Case
Sandboxpaymint_test_Development and testing
Productionpaymint_live_Live application

​
Managing Keys

From the Settings → API Keys page in the Paymint dashboard, you can:
  • View all your keys with their status and last usage date
  • Revoke keys that are no longer needed
  • Create new keys for different environments or services

​
Next Steps

Integration Example

Use your API key in a complete Next.js integration

Next.js SDK

Full API reference for hooks and server utilities