One API. Every payment provider.
Billing without borders.

npm install pimabill

pip install pimabill

import { PimaBillClient } from 'pimabill';

const pima = new PimaBillClient({
  token: process.env.PIMABILL_API_KEY!,
});

// Create a customer
const customer = await pima.customers.create({
  externalId: 'usr_001',
  email: 'amina@kampaltech.ug',
  name: 'Amina Nakato',
  currency: 'UGX',
});

// Subscribe them to a plan
const sub = await pima.subscriptions.create({
  customerId: customer.id,
  planId: 'plan_growth',
  currency: 'UGX',
});

console.log(sub.status); // "ACTIVE"

import os
from pimabill import PimaBillClient

pima = PimaBillClient(token=os.environ["PIMABILL_API_KEY"])

# Create a customer
customer = pima.customers.create(
    external_id="usr_001",
    email="amina@kampaltech.ug",
    name="Amina Nakato",
    currency="UGX",
)

# Subscribe them to a plan
sub = pima.subscriptions.create(
    customer_id=customer.id,
    plan_id="plan_growth",
    currency="UGX",
)

print(sub.status)  # "ACTIVE"

# Create a customer
curl -X POST http://localhost:4000/api/customers \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "usr_001",
    "email": "amina@kampaltech.ug",
    "name": "Amina Nakato",
    "currency": "UGX"
  }'

# Create a subscription
curl -X POST http://localhost:4000/api/subscriptions \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cust_abc123",
    "planId": "plan_growth",
    "currency": "UGX"
  }'