Skip to content
FinStack Docs

Quick Start

1. Get an API key

Section titled “1. Get an API key”

Sign in to the FinStack dashboard and generate an API key from Settings → API Keys.

Your key looks like: sk_live_<tenant>_<random32>

2. Create a customer

Section titled “2. Create a customer”
Terminal window
curl -X POST https://api.finstack.dev/v1/customers \
  -H "Authorization: Bearer sk_live_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Jane Smith",
    "email": "[email protected]",
    "idempotency_key": "cust_jane_001"
  }'

Response:

{
  "id": "01927b3e-...",
  "tenant_id": "...",
  "name": "Jane Smith",
  "email": "[email protected]",
  "created_at": "2026-06-01T00:00:00Z"
}

3. Create a payment

Section titled “3. Create a payment”
Terminal window
curl -X POST https://api.finstack.dev/v1/payments \
  -H "Authorization: Bearer sk_live_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "amount_minor": 1000,
    "currency": "USD",
    "method": "card",
    "customer_id": "01927b3e-...",
    "description": "Order #1234",
    "idempotency_key": "pay_order_1234"
  }'

amount_minor is in the currency’s smallest unit — 1000 = $10.00 USD.

4. Capture the payment

Section titled “4. Capture the payment”
Terminal window
curl -X POST https://api.finstack.dev/v1/payments/{id}/capture \
  -H "Authorization: Bearer sk_live_<your-key>"

Next steps

Section titled “Next steps”