Bachs documentation

Payments built for internet businesses.

Guides, references and working code for every Bachs flow, all testable in the sandbox.

Get started How Bachs works

Build with Bachs

Accept a payment
Sell a subscription
Pay a seller
Forward webhooks

Hosted checkout, confirmed by a webhook

Create a checkout session with a product from your catalog, send the customer to the hosted page, and fulfil the order when collection.succeeded arrives.Accept a payment with Checkout

curl https://sandbox-api.bachs.io/v1/checkout-sessions \
  -H "Authorization: Bearer $BACHS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      { "product_id": "prod_abc123", "quantity": 1 }
    ],
    "customer": { "email": "ngozi@example.com", "name": "Ngozi Okafor" },
    "success_url": "https://shop.example.com/thanks",
    "cancel_url": "https://shop.example.com/cart"
  }'

const checkout = await bachs.checkoutSessions.create(
  {
    product_cart: [{ product_id: "prod_abc123", quantity: 1 }],
    customer: { email: "ngozi@example.com", name: "Ngozi Okafor" },
    success_url: "https://shop.example.com/thanks",
    cancel_url: "https://shop.example.com/cart",
  },
  { idempotencyKey: `checkout-${order.id}` },
);

checkout = bachs.checkout_sessions.create(
    product_cart=[{"product_id": "prod_abc123", "quantity": 1}],
    customer={"email": "ngozi@example.com", "name": "Ngozi Okafor"},
    success_url="https://shop.example.com/thanks",
    cancel_url="https://shop.example.com/cart",
    idempotency_key=f"checkout-{order.id}",
)

A checkout for a recurring product

A subscription starts when a customer completes a checkout for a product with a recurring price. Send a customer so Bachs knows who to charge on every renewal, and your own user id in metadata.Sell SaaS subscriptions

curl -X POST https://sandbox-api.bachs.io/v1/checkout-sessions \
  -H "Authorization: Bearer $BACHS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [{ "product_id": "prod_8f3a2c9d1e4b7a6c5d0f", "quantity": 1 }],
    "customer": { "email": "ngozi@example.com", "name": "Ngozi Okafor" },
    "billing_currency": "USD",
    "metadata": { "user_id": "8812" },
    "success_url": "https://app.example.com/billing/success",
    "cancel_url": "https://app.example.com/pricing"
  }'

{
  "checkout_id": "chk_2N3o4P5q6R7s8T9u",
  "checkout_url": "https://checkout.bachs.io/c/V8xQ2mZpLj9RfTa",
  "status": "open",
  "expires_at": "2026-10-09T10:00:00Z",
  "created_at": "2026-10-09T09:00:00Z"
}

One sale, split at settlement

Name the seller’s sub account in transfer_data and your cut in platform_fee. The customer pays once, the seller’s share lands in their balance, and the fee is yours.Build a marketplace

curl -X POST https://sandbox-api.bachs.io/v1/checkout-sessions \
  -H "Authorization: Bearer sk_sandbox_abc123xyz..." \
  -H "Content-Type: application/json" \
  -d '{
    "product_cart": [
      { "product_id": "prod_a3ef11afb6c446f9ba41", "quantity": 1 }
    ],
    "transfer_data": { "destination": "acct_Shi4LnKkKht5bmbS" },
    "platform_fee": "20000.00",
    "customer": { "email": "ngozi@example.com" },
    "success_url": "https://example.com/thank-you",
    "cancel_url": "https://example.com/checkout"
  }'

{
  "checkout_id": "chk_yMpCSunbArKaSnzJ",
  "status": "open",
  "amount": "100000.00",
  "currency": "NGN",
  "platform_fee": "20000.00",
  "checkout_url": "https://sandbox-checkout.bachs.io/c/SfxP7y-gSkzJsZs"
}

Live sandbox events on localhost

The CLI pairs with your account through the browser and forwards every sandbox event to a port on your machine. Trigger a sample event to check your handler before a real payment arrives.Test webhooks locally

bachs listen --forward-to localhost:3000/webhooks

bachs trigger collection.succeeded

Browse by product

Payments

CheckoutHosted and overlay checkout for one-time payments.Payment methodsCards, bank transfers and mobile money, by currency.Virtual accountsA permanent NGN account number for bank transfers.Refunds and disputesReturn a payment and answer a chargeback.

Billing

Products and pricingFixed, free or custom prices, in local currencies.SubscriptionsRecurring plans, trials, upgrades and payment recovery.Customer portalA hosted page where customers manage their own billing.

Payouts

PayoutsWithdraw your balance from the dashboard or the API.Automatic payoutsPay out settled collections on a schedule.Payout currencies and methodsWhere you can pay out and the details each route needs.

Connect

Sub accountsA balance of its own for every seller or partner.Split paymentsTake your platform’s cut of each sale.OnboardingCollect each account’s details from the dashboard, a hosted link or the API.

Developers and help

API reference

Every endpoint, object and error.

SDKs

Node.js and Python, the checkout overlay, the CLI.

Changelog

What shipped, week by week.

Support

Direct help from the team.

Overview

Start building

Common use cases

More resources

Payments built for internet businesses.

Payments

Billing

Payouts and Connect

Developers

Build with Bachs

Hosted checkout, confirmed by a webhook

A checkout for a recurring product

One sale, split at settlement

Live sandbox events on localhost

Browse by product

Payments

Billing

Payouts

Connect

Developers and help

API reference

SDKs

Changelog

Support