Bonitätsprüfung REST API für B2B-Kreditentscheidungen

Die Boniforce REST API ist eine moderne JSON-Schnittstelle für die automatische B2B-Bonitätsprüfung. Sie senden Steuer-ID, HRB oder Firmenname und erhalten zurück: Boniscore (0–100), Kreditlimit in Euro und ein Ampelsystem (Freigabe / Manuelle Prüfung / Ablehnen) – direkt in Ihr ERP, CRM oder Webshop.

Im Boniforce-Dashboard unter dashboard.boniforce.de. Nach dem Login klicken Sie in der Seitenleiste auf „API-Schlüssel“ und dann auf „Neuen Schlüssel erstellen“. Sie können beliebig viele Schlüssel anlegen, mit Namen versehen (z. B. „shopware-prod“) und jederzeit sperren oder rotieren. Das Format lautet immer sk_live_….

Ja. Aus Sicherheitsgründen wird der vollständige Key nur direkt nach Erstellung einmalig angezeigt. Danach sehen Sie im Dashboard nur die letzten Zeichen (z. B. sk_live_*****8J2E). Bewahren Sie den Key in einem Passwort-Manager oder Secret-Store (Vault, AWS Secrets Manager, etc.) auf. Bei Verlust einfach neuen Key erstellen und alten sperren.

Ja, unter sandbox.boniforce.de – komplett kostenlos und ohne Login. Sie können alle Endpunkte direkt im Browser über die Swagger-UI testen. Die Sandbox liefert künstliche Daten und verbraucht keine Credits. Identisches Schema wie die Live-API, nur mit Test-Präfix sk_test_.

Das Präfix bestimmt die Umgebung. sk_live_… verbindet die Boniforce Live-API mit echten Bonitätsdaten – jede Anfrage verbraucht ein Credit. sk_test_… ist für die Sandbox – kostenlose Anfragen mit künstlichen Daten. Beide Keys nutzen identische Endpunkte und das gleiche JSON-Schema, sodass ein Wechsel von Test auf Live nur den Key-Austausch erfordert.

Die Boniforce API spricht REST + JSON – den Standard, den jede moderne Programmiersprache und jedes ERP/CRM unterstützt. Eine Integration in SAP, Microsoft Dynamics, Shopware, Magento, Salesforce, HubSpot oder Pipedrive ist in wenigen Stunden umsetzbar. Code-Beispiele für Node.js, Python und PHP finden Sie auf dieser Seite – für ERP-/CRM-spezifische Anbindungen siehe ERP & CRM-Integration und B2B-Shop-Integration.

Das Ampelsystem liefert eine direkte Handlungsempfehlung im Feld "recommendation":

Grün („Freigabe“) – Transaktion kann automatisiert freigegeben werden.
Gelb („Manuelle Prüfung“) – Mitarbeiter sollte den Fall prüfen.
Rot („Ablehnen“) – Hohes Ausfallrisiko, kein Rechnungskauf.

So müssen Sie keine eigene Scoring-Logik bauen. Die Schwellen lassen sich auf Wunsch individuell anpassen.

Synchrone Quick-Checks (Score & Risikoampel ohne Bilanzanalyse) antworten in unter 200 ms. Deep-Checks mit Bundesanzeiger-Bilanzdaten (?include_financials=true) dauern typischerweise 20–30 Sekunden – diese laufen asynchron und das Ergebnis kommt per Webhook.

Der Boniscore ist ein Wert zwischen 0 und 100, der die Bonität eines deutschen Unternehmens zusammenfasst – aggregiert aus Handelsregister, Bundesanzeiger, Insolvenzdaten und weiteren öffentlichen Quellen. Die Kategorien sind: EXCELLENT (90–100), GOOD (70–89), MEDIUM (50–69), WEAK (30–49), HIGH_RISK (0–29).

Die Sandbox ist kostenlos. Das Flex-Starter-Paket kostet 290 € für 100 Live-Prüfungen – einmalig, ohne Abo, ohne Vertrag. Für höhere Volumen (ab 1.000 Prüfungen pro Monat) gibt es individuelle Enterprise-Preise mit Volumenrabatt – auf Anfrage.

Klassische Auskunfteien sind häufig auf Geschäftsmodelle mit Rahmenverträgen und etablierten Schnittstellen-Standards (z. B. SOAP/XML) ausgerichtet. Boniforce ist von Grund auf API-First gebaut: REST + JSON, Prepaid statt Jahresvertrag, Sandbox ohne Login – mit dem Fokus auf schnelle Integration in moderne Webshops, ERPs und CRMs. Welcher Ansatz besser passt, hängt vom konkreten Anwendungsfall und Volumen ab.

Ja. Bei langen Deep-Checks (~30s) blockiert die API Ihren Checkout nicht – das Ergebnis wird per HTTP-POST an Ihre konfigurierte Webhook-URL gesendet. Außerdem gibt es Event-Webhooks für Insolvenz-Monitoring: Sobald ein Bestandskunde insolvent wird, erhalten Sie automatisch eine Benachrichtigung.

Ja. Sie können Bestandskunden über die API zum Monitoring registrieren – sobald eine Veränderung im Score oder ein Insolvenz-Eintrag erfasst wird, erhalten Sie eine Webhook-Benachrichtigung. So lernen Sie früh von Risiken, ohne manuell nachzufassen.

Bearer-Token-Authentifizierung über den Authorization-Header: Authorization: Bearer sk_live_…. Pro Request ein Header – kein OAuth-Tanz, keine Token-Refresh-Logik nötig. Bei Bedarf können Sie pro Anwendung einen eigenen Key anlegen, um Logs zuzuordnen.

Standard-Rate-Limit: 60 Requests pro Minute pro API-Key. Für Bulk-Operationen empfehlen wir den dedizierten Bulk-Endpoint, der mehrere Firmen in einem Request prüft. Enterprise-Kunden erhalten höhere Limits.

Standard-Response: Boniscore, Kreditlimit, Ampelsystem, Insolvenz-Flag, Firmenname. Optional erweiterbar (?include_financials=true) um: Eigenkapitalquote, Umsatzentwicklung, Ergebnis vor Steuern, Liquidität, Verschuldungsgrad – soweit Bundesanzeiger-Daten verfügbar sind.

Nein. Jede Anfrage prüft Handelsregister und Bundesanzeiger live, sodass Sie immer den aktuellen Stand bekommen. Falls Sie selbst cachen wollen (z. B. in Ihrem ERP), können Sie das auf Ihrer Seite tun – wir empfehlen aber, hochrelevante Entscheidungen (Limit-Erhöhungen, Großaufträge) immer mit einem Live-Call abzusichern.

Ja. Server stehen in Deutschland, AV-Verträge werden bereitgestellt, Datenverarbeitung erfolgt im Rahmen der DSGVO und unter Berücksichtigung des Bundesdatenschutzgesetzes. Es werden ausschließlich Firmendaten verarbeitet – keine personenbezogenen Daten von Verbrauchern.

Ja. Boniforce bietet sechs Integrationswege: Online-Portal, ERP & CRM, B2B-Shop, ChatGPT-Agent, Claude über MCP-Connector und REST API. Wer keinen Code schreiben will, nutzt das Online-Portal, den ChatGPT-Agent oder den Claude-Connector. Eine Übersicht aller Wege gibt’s auf der Integrationen-Seite.

Boniforce nutzt einen offenen REST-Standard mit OpenAPI-3.0-Spec, den jeder Code-Generator (openapi-generator, swagger-codegen) in eine Client-Library für jede Sprache umwandelt. Offizielle SDKs für Node.js und Python sind in Arbeit und auf Anfrage als Beta verfügbar.

Die API hat eine Verfügbarkeit von > 99,9 % im Jahresdurchschnitt. Bei einem Ausfall der Datenquellen (z. B. Bundesanzeiger) wird eine HTTP 503 mit retry_after-Header zurückgegeben – Ihr Client kann die Anfrage später wiederholen. Bei Webhook-Workflows werden Auslieferungen mit Exponential-Backoff automatisch retried.