Skip to main content

Selva API docs

Everything you need to authenticate, move money, subscribe to events, and keep finance teams in sync.

Start buildingView API reference
OpenAPI specReference stays in lockstep with production
TypeScript SDKTyped clients with request/response helpers
Sandbox fixturesDeterministic data for integration tests

Core modules

Authentication

Exchange client credentials for scoped tokens with predictable expiry.

View docs

Payments

Create, capture, void, and refund charges with idempotency keys.

View docs

Accounts

Issue accounts, fetch balances, and manage permissions programmatically.

View docs

Webhooks

Subscribe, verify signatures, and replay events safely.

View docs

Common workflows

Follow these guides end-to-end, then adapt to your stack.

  1. Accept a payment
    Create a charge, confirm, and capture with idempotency guarantees.
    Guide
  2. Handle webhooks
    Register endpoints, validate signatures, and process retries deterministically.
    Guide
  3. Reconcile settlements
    Match payouts to ledger entries and export finance-ready reports.
    Guide

Integration path

The sequence most teams follow from test to prod.

  1. Create an API key

    Create an API key in sandbox.

  2. Call payments and accounts

    Call payments and accounts endpoints with your credentials.

  3. Subscribe to webhooks

    Subscribe to webhooks and confirm signatures.

  4. Move to production

    Move to production with monitoring and alerting built in.