Contract v1.0.0

← Integrations

Revolut Business

Coming soon (platform verification) Bank

Reads account balances and transactions so cash on hand is known and bank movements are reconciled with integrations.

What we pull

  • accounts and balances
  • transactions (completed)

Every record lands as a financial event with source_type, external_id (deduplicated on re-sync) and provenance. Mode: mock.

Signals and sync

  • Scheduled sync only (no webhooks).
  • Sync interval: every 15 minutes.
  • Health signals: auth_expired, silent (no sync for over twice the interval), error. Each becomes an in-app notification for the owner and shows in Integrations.

Permissions and secrets

  • Business API certificate (public key)
  • OAuth consent with read-only access to accounts and transactions

Secrets are encrypted at rest (AES-256-GCM, per-owner) and never returned by the API; the panel shows only the last 4 characters and the date. Read-only keys wherever the provider offers them.

Availability

Coming soon: the provider is verifying our app. Agents can already plan budgets and reserve capital; live data arrives once the review is done. Use “Notify me” in the panel.

Setup steps

From the Integrator’s owner checklist (Polish; the panel walks you through the same steps).

Dopóki nie zdecydujesz, że chcesz podłączyć bank, nic tu nie rób (w panelu widnieją jako „Available soon”). Gdy zdecydujesz:

F1. Revolut Business (20 min + zgoda w aplikacji)

  1. Wygeneruj lokalnie parę kluczy (poprosimy o polecenie openssl; klucz prywatny zostaje u Ciebie / w Railway jako REVOLUT_BUSINESS_PRIVATE_KEY, nigdy w czacie).
  2. Revolut Business (web) → Settings → APIs → Business API → Add certificate → wklej klucz PUBLICZNY (.pem), OAuth redirect URI: https://api-production-3516.up.railway.app/v1/integrations/revolut_business/callback → Continue.
  3. Zapisz Client ID → Railway REVOLUT_BUSINESS_CLIENT_ID. Kliknij Enable API access → zatwierdź w aplikacji mobilnej Revolut (2FA). Po naszym sygnale klikniesz „Connect” w panelu Operlance: zgoda → kod → API wymienia go na token (REVOLUT_BUSINESS_ACCESS_TOKEN i refresh token trzyma API, nie Ty). Refresh token wygasa po 90 dniach: panel poprosi o ponowną zgodę.
  4. Uprawnienia: wyłącznie odczyt (accounts, transactions). Nie włączaj Payments ani Counterparties dla naszej aplikacji.

F2. Wise Business (10 min)

  1. Wise Business (web) → Settings → API tokens → Add new token → nazwa Operlance read-only, Read only (NIE Full access) → skopiuj → Railway WISE_API_TOKEN (pokazany raz).
  2. Profile ID: Settings → Business → Profile ID (albo podamy go z API po tokenie) → Railway WISE_PROFILE_ID.
  3. Jeśli Wise zażąda potwierdzenia SCA dla wyciągów, poprosimy o rejestrację klucza publicznego w Settings → API tokens → Manage public keys (prywatny w Railway jako WISE_PRIVATE_KEY).

Czego NIE udostępniać: loginów i haseł do bankowości, kodów z aplikacji, tokenów Full access, kluczy prywatnych poza Railway, numerów kart. Operlance nigdy nie wykonuje przelewów; jeśli jakikolwiek ekran prosi o zgodę na płatności, przerwij i napisz do Mózgu.