omnibank / qonto

1.x-dev 2026-10-03 16:02 UTC

Requires

• php: >=8.2
• glitchr/omnibank: ^1.0@dev
• symfony/http-client-contracts: ^3.0

Requires (Dev)

• phpunit/phpunit: ^11.0
• symfony/http-client: ^6.4|^7.0|^8.0

Suggests

• symfony/http-client: The HTTP client the gateway talks through

LGPL-3.0-or-later

• Marco Meyer

• Bank
• qonto
• omnibank

Published on Packagist.org on 2026-10-03 16:11 UTC

README

Qonto for glitchr/omnibank: the organization's accounts, their balances and their settled transactions, over Qonto's Business API with an API key.

Unverified. Written from Qonto's published API documentation and recorded answers (Tests/Fixtures); it has not yet been run against a real Qonto organization or the sandbox. Try it with real keys (docker compose run --rm omnibank accounts qonto in glitchr/omnibank's docker/) before relying on it, and drop this notice once it holds.

omnibank:
    gateways:
        treasury:
            factory: qonto
            options:
                login: '%env(QONTO_LOGIN)%'              # the organization's login (slug-like)
                secret_key: '%env(QONTO_SECRET_KEY)%'
                sandbox: false                           # true: thirdparty-sandbox.staging.qonto.co
                staging_token: '%env(QONTO_STAGING_TOKEN)%'   # the sandbox's X-Qonto-Staging-Token

• connect() has nothing to do (the key is the access): no page, the consent active.
• accounts() - GET /v2/organization: its bank_accounts (id, IBAN, BIC, name, currency).
• balances() - balance_cents (booked) and authorized_balance_cents (available).
• transactions() - GET /v2/transactions?iban=…&status[]=completed&settled_at_from=…&settled_at_to=…, every page (meta.next_page); side: debit is money gone out (negative), amount_cents, the label as counterparty, the transfer's counterparty IBAN when Qonto includes it, reference.
• No transfer() nor notify() in this version: RequestNotSupportedException.

Calls go as Authorization: {login}:{secret-key} to https://thirdparty.qonto.com. A 5xx, a 429 or a network failure is an UnavailableException, never an empty list.

Credentials: in Qonto, Settings → Integrations & partnerships → API key: the login and the secret key (an owner or admin can see them). For the sandbox, an account on Qonto's developer portal gives a sandbox organization and its staging token.

License: LGPL-3.0-or-later.