Introduction

The Bachs API lets you create products, run checkouts, manage customers and subscriptions, pay out to bank accounts and wallets, and reconcile it all programmatically. It is organized around REST, uses predictable resource-oriented URLs, and returns JSON. The conventions every endpoint shares are collected in one place:

API Standards: authentication, request and response format, base URLs, status codes, query parameters, and rate limits.
Authentication: create keys and authorize requests with a Bearer token.
Errors: the error object and how to handle failures.
Sandbox: test your integration without moving real funds.

Your first request

Authenticate with your secret key in the Authorization header and call any endpoint. Use the sandbox base URL (https://sandbox-api.bachs.io) while you build, and the production base URL (https://api.bachs.io) when you go live. This lists your products:

curl https://sandbox-api.bachs.io/v1/products \
  -H "Authorization: Bearer $BACHS_API_KEY" \
  -H "Accept: application/json"

curl https://api.bachs.io/v1/products \
  -H "Authorization: Bearer $BACHS_API_KEY" \
  -H "Accept: application/json"

Use sk_sandbox_... keys against the sandbox and sk_live_... keys against production. See Authentication to create and manage keys, and API Standards for the full base-URL reference.

Next steps

Create a product: define your billing catalog with fixed, free, or custom pricing.
Start a checkout: create a hosted checkout and get paid.
Pay someone out: send money to a bank account or wallet, in two calls.
Permissions: scopes and what each key can access.
Pagination: page through list endpoints.

General

Checkout Sessions

Connected Accounts

Products

Subscriptions

Customers

Customer sessions

Payments

Refunds

Payouts

Payout Destinations

Balance

Virtual accounts

Media

Misc

Transfers

Persons

Platform Fees

Reference

Introduction

Your first request

Next steps

​Your first request

​Next steps

Your first request

Next steps