Authentication

Secure your API requests with API keys and authentication tokens

Key Types

Bearer Token

Auth Method

Supported

Key Rotation

Granular

Scopes

API Keys

The Solid API uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard under Settings → API Keys.

Keep your keys secure

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, etc.

Key Types

sk_live_...PRODUCTION

Live keys - Use these in production. Real charges, real customers, real money.

sk_test_...TESTING

Test keys - Safe for development. No real charges, no real money.

pk_live_...PUBLIC

Publishable keys - Safe to use in client-side code. Limited permissions.

Authentication Header

All API requests must include your API key in the Authorization header:

Header

Authorization: Bearer sk_live_your_api_key_here

Authentication is required

Requests without authentication will return a 401 Unauthorized error.

Code Examples

JavaScript / Node.js

const solid = new Solid({
  apiKey: process.env.SOLID_API_KEY
});

const payment = await solid.payments.create({
  amount: 5000,
  currency: 'usd'
});

Python

import solid

solid.api_key = 'sk_live_your_api_key_here'

payment = solid.Payment.create(
    amount=5000,
    currency='usd'
)

cURL

curl https://api.solidnumber.com/v1/payments \
  -H "Authorization: Bearer sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "usd"
  }'