Garanti BBVA API for Dolibarr
Account statement Bulk payments Virtual accounts Request to pay DBS direct collection Four-eyes approval Audit trail Free · GPLv3
Overview
Garanti BBVA API is a free external module for Dolibarr ERP/CRM that connects Dolibarr to the corporate APIs of the Turkish bank Garanti BBVA (developer portal, OAuth client credentials).
Each Garanti API requires a separate permission from the bank, so each one is a separate service in the module: you enable only the services your company is allowed to use. A disabled service has no menu, tab, scheduled job, MCP tool or API call.
The module does not modify any Dolibarr core file. It is a community project and is not affiliated with Türkiye Garanti Bankası A.Ş.
Publisher and support
| Item | Information |
|---|---|
| Publisher | M. Burak Şentürk |
| Website | https://buraksenturk.net |
| Support | https://github.com/mbrksntrk/dolibarr-garanti-api/issues |
| Source code | https://github.com/mbrksntrk/dolibarr-garanti-api |
Module information
| Information | Detail |
|---|---|
| Module name | Garanti BBVA API (garantiapi)
|
| Module number | 194094 |
| Main use | Bank statement import, bulk payments, virtual accounts, request to pay and direct collection with Garanti BBVA |
| Type | External Dolibarr module |
| Family | Financial |
| Documented version | 2.0.0 |
| Dolibarr compatibility | Dolibarr 20.0 or higher (developed and tested on 24.0) |
| PHP compatibility | PHP 8.1 or higher, with curl, json, openssl
|
| Required modules | Banks, Third parties |
| Dolibarr core modification | No |
| License | GNU GPL v3 or later (with an author attribution term) |
| Price | Free (a Garanti BBVA corporate account and API permissions are required) |
| Available languages | Turkish, English |
Official links
- DoliStore: Garanti BBVA API
- Source code and releases: GitHub
- Detailed documentation (Turkish): GitHub wiki
Services
| Service | What it does in Dolibarr |
|---|---|
| Account statement | Balances and enriched transactions; suggestions to match a bank line, an invoice or a miscellaneous payment; reconciliation; balance difference check. |
| Bulk payments | Payment orders for supplier invoices, salaries and expense reports; four-eyes approval, limits, IBAN–tax number check before sending, status tracking, cancellation; paid lines booked as Dolibarr payments. |
| Virtual accounts | One IBAN per customer; incoming money is matched to the exact third party; __GARANTIAPI_VIRTUAL_IBAN__ substitution key for documents and e-mails.
|
| Request to pay | FAST payment request from an invoice, JWS signature (RS256 / ES256, key generator included), status, cancellation; booked as customer payment when paid. |
| DBS (direct collection) | Dealer contracts and limits, invoice submission (add / modify / delete), collection tracking and booking. |
Main features
- Per-service enable/disable and per-service access test (401/403 = no permission from the bank).
- Audit trail: every API call (endpoint, HTTP code, duration, request id, masked request/response) and every business action (approval, sending, cancellation, booking, setting change) with user and IP; filters, CSV export, history on object cards.
- Payment safety: money-moving calls are never retried automatically; a rejected order returns to pending, an unknown result is resolved by status queries.
- Native bookings: customer/supplier invoice payments, salary, expense report and miscellaneous payments, bank reconciliation.
- Scheduled jobs per service (disabled by default).
- MCP tools for the Dolibarr 24 AI module.
- Test suite with a mock bank (
tests/garantiapi_test.php).
Menus
Under the Bank menu: Garanti BBVA dashboard, transactions, accounts, payment orders, virtual accounts, payment requests, DBS and audit log (only for enabled services). Tabs are added on bank account, third party and invoice cards.
Configuration
From Home → Setup → Modules → Garanti BBVA API:
- environment (test / production), client id and secret from the Garanti developer portal, consent id for the account statement;
- Services page: enable the services you have permission for and run the access test;
- map each Garanti account to a Dolibarr bank account;
- service-specific settings (limits, approval rules, JWS key, DBS codes…). Codes that the bank only documents with examples are configurable — confirm them with the bank before going live.
User permissions
Fine-grained rights per service: read / sync / match the statement, manage account mappings; read / prepare / approve / send payment orders; read / manage virtual accounts; read / send payment requests; read / manage DBS; read the audit log.
Installation
- Download
module_garantiapi-x.y.z.zipfrom DoliStore or GitHub Releases. - Home → Setup → Modules → Deploy/install external app/module, or unzip into
htdocs/custom/. - Enable Garanti BBVA API (Banks module required).
- Enter the API credentials, enable your services, run the access test, map the accounts.
Summary
Garanti BBVA API brings the bank's statement, bulk payment, virtual account, request to pay and DBS APIs into Dolibarr, one permission-based service at a time, books results as native Dolibarr payments and records every call and action in an audit trail — without any change to the Dolibarr core.