Finscale documentation

Finscale is a payment orchestration gateway. You integrate one REST API; behind it, Finscale routes every transaction across multiple payment providers — picking the one most likely to approve it, and failing over automatically when one declines or times out. 40+ payment methods, one integration, one unified model for errors, refunds, and reconciliation.

Your first request

Everything runs through https://api.finscale.dev/v1. The test sandbox is live — any sk_test_ key authenticates. One call creates a payment; Finscale picks the provider:

curl https://api.finscale.dev/v1/payments \
  -H "Authorization: Bearer sk_test_51FinscaleDemo…" \
  -H "Idempotency-Key: idem_ord_9f21_0716" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4900,
    "currency": "EUR",
    "payment_method": "ideal",
    "reference": "ord_9f21_0716",
    "customer": { "email": "anna@example.com" },
    "return_url": "https://shop.example.com/checkout/return"
  }'

The response carries the routed provider as an opaque id ("provider": "prov_eu_acq_01") and, for redirect methods like iDEAL, a next_action URL to send your customer to. The quickstart walks the whole story, and the API playground lets you fire these calls from the browser.

Explore the docs

The docs follow the sidebar: eight groups, from first payment to going live.