Typische Fehler bei der CiviCRM Anbindung

Bei der Anbindung zu CiviCRM kann es ab und an zu Fehlern oder Fehlkonfiguration kommen. Hier sind die häufigsten Probleme.

Konfigurationsprobleme

Einige Probleme lassen sich durch die Konfiguration in twingle oder in CiviCRM beheben. Hier sind einige typische Konfigurations-Probleme. 

Daten von neuen Spenden werden nicht übertragen

  • Bitte prüfe, ob du im entsprechenden twingle-Projekt in den Projekteinstellungen unter Kontaktdaten & Einbindung die Datenübertragung aktiviert hast:

Änderungen an Daten in twingle werden nicht übertragen

  • Generell werden alle Daten nur einmal an CiviCRM übertragen, es gibt derzeit keinen Updatemechanismus.
  • Du kannst in den globalen Einstellungen im Reiter Allgemein eine verzögerte Übertragung aktivieren. Dadurch werden die Daten der Spende erst später übertragen und enthalten dann alle, bis dahin gemachten, Updates. Die Verzögerung kannst du in der Einstellung Verzögerte Übermittlung neuer Zahlungen zwischen 3 und 30 Minuten wählen.

Anmeldungen zum Newsletter oder personenbezogene Daten kommen nicht in CiviCRM an

  • Wenn im Twingle-Projekte die Eingabe der persönlichen Daten nach der Spende erfolgt oder die spendende Person eine Newsletter-Anmeldung gemacht hat, ist diese nicht in CiviCRM zu sehen
  • Du kannst in den globalen Einstellungen im Reiter Allgemein eine verzögerte Übertragung aktivieren. Dadurch werden die Daten der Spende erst später übertragen und enthalten dann alle Daten. Die Verzögerung kannst du in der Einstellung Verzögerte Übermittlung neuer Zahlungen zwischen 3 und 30 Minuten wählen.

Wiederholte Übertragungsversuche und Fehlermails

Schlägt die Übertragung an CiviCRM fehl (z. B. weil CiviCRM nicht erreichbar ist), versucht twingle sie automatisch mehrfach erneut, mit größer werdenden Abständen über mehrere Stunden (rund einen Tag). Wird der Fehler in dieser Zeit behoben, kommt die Zahlung automatisch in CiviCRM an. Erst wenn alle Versuche fehlgeschlagen sind, erhältst du die Fehlermail. Nach dem Ende der Versuche wird die Zahlung nicht automatisch erneut übertragen. Pro Projekt und Schnittstelle bekommst du nur eine Fehlermail, bis wieder eine Übertragung erfolgreich war; weitere gleichartige Fehler lösen keine weiteren Mails aus.

Fehler in Fehlermails

Wenn die Übertragung der Daten an der Schnittstelle fehlschlägt und das CiviCRM einen Fehler an twingle zurück schickt, dann bekommst du nach einigen Übertragungsversuchen eine E-Mail mit der Fehlermeldung. Hier sind einige dieser Fehlermeldungen aufgelistet.

API 'version' information missing

  • vermutlich setzt du das Plugin CiviProxy ein
  • Bearbeite die URL der twingle Schnittstelle in den Einstellungen im twingleMANAGER und
    hänge an die URL ein ?version=3 an

Payment method could not be matched to existing payment instrument. / Zahlungsmethode konnte keiner existierenden Zahlungsmethode zugeordnet werden.

  • Bei der genannten Spende ist ein Zahlungsmittel benutzt worden, was im CiviCRM nicht zugeordnet werden konnten
  • Bitte überprüfe die Konfiguration an der CiviCRM Schnittstelle bei dir im System und ob alle im Twingle-Projekt aktivierten Zahlungsmethoden auch in deinem CiviCRM vorhanden sind.

504 Gateway Time-out / 500 Service unavailable

  • Das CiviCRM System konnte nicht erreicht werden.
  • Das Problem tritt in der Regel nur temporär auf Grund von Wartungsarbeiten oder Netzwerkproblemen auf und ist meist wenige Minuten später automatisch behoben.

Mandatory key(s) missing from params array: one of (...)

  • Ein oder mehrere Felder in CiviCRM sind als Pflichtfelder markiert, in twingle aber nicht und fehlen daher bei der Datenübertragung.
  • Passe die Einstellungen in twingle oder in CiviCRM an, so dass die Pflichtfelder übereinstimmen.

Could not change transaction XXXXXXX in civi crm: Error was HTTP/1.1 500 Internal Server Error returned for ...

  • Eine bereits gestoppte Dauerspende soll noch einmal auf gestoppt gesetzt werden
  • Bekannter Fehler in der Civi-Extension bis zur Version 1.6.x (Github-Issue). Ist in Version 1.7 (vom Mai 2026) gefixt.

Authorization failed: CiviCRM APIv4 (FinancialType::get)

  • Im CiviCRM fehlt bei den Zugangsdaten für die twingle Schnittstelle eine Rechteeinstellung.
  • vermutlich wurde die Fehlermeldung durch ein Update in einem installierten Plugin ausgelöst

CRM_Twingle_Profile::getProfile(): Argument #1 ($id) must be of type ?int, string given

  • Bekannter Fehler in der CiviCRM Extension in den Versionen bis 1.6
  • Mache ein Update der Extension auf mindestens die Version 1.7
Kann ich einen externen Webhook (für Salesforce) anbinden?
Wie können Spendendaten automatisch an HubSpot übermittelt werden?