p798 - Passworte (pwdsu)
Muss als Benutzer "sogadm" eingestellt werden. Dabei muss ein RSA-Schlüssel verwendet werden, den alle Benutzer sehen können.
API.payments.commdoo | <Client-ID> | <Shared Secret> |
c187 - Zahlungsarten (zahlart)
Im Feld api_config werden kommagetrennt mehrere Parameter eingetragen:
paymentkey=<key> | <key> durch den von CommDoo bereitgestellte Paymentkey ersetzen |
noauth | Verhindert sofortige Buchungen mit dieser Zahlart (aus SOG ERP) |
nopreauth | Verhindert Autorisierungen (Reservierungen) mit dieser Zahlart (aus SOG ERP) |
Beispiel: paymentkey=creditcard
-> Es wird der Paymentkey "creditcard" genutzt.
Beispiel: paymentkey=creditcard,noauth
-> Es wird der Paymentkey "creditcard" genutzt. Zahlungen als sofortige Buchung sind nicht erlaubt.
Beispiel: paymentkey=sofortueberweisung,nopreauth
-> Es wird der Paymentkey "sofortueberweisung" genutzt. Zahlungen als Autorisierung (Reservierung) sind nicht erlaubt.
Hinweis zum Paymentkey:
Aus organisatorischen Gründen sollte für jede Zahlungsart bei CommDoo ein Paymentkey erstellt werden, welcher nur 1 Zahlungsmittel zulässt. Die Gültigkeit des Zahlungslinks für in SOG ERP erstellte Zahlungsaufforderungen lässt sich bei CommDoo am Paymentkey konfigurieren.
Falls eine Shop-Anbindung genutzt wird, sollte für jedes Zahlungsmittel 1 Paar von Paymentkeys erstellt werden. Mit Ausnahme der Gültigkeit sollten die Parameter jeweils übereinstimmen. Dadurch kann im Shop ein Paymentkey mit normaler Gültigkeit genutzt werden und in SOG ERP ein Paymentkey, für welchen eine längere Gültigkeit konfiguriert wurde. Bei späteren Änderungen muss darauf geachtet werden, dass beide Paymentkeys angepasst werden.
Beispiel:
Paymentkey "creditcard" für den Shop
-> Im Shop muss die Zahlung weiterhin innerhalb der normalen Frist (aktuell 10 Minuten) erfolgen.
Paymentkey "creditcard-24h" für SOG ERP
-> In SOG ERP erfolgt die Zahlung über einen Link, der per Email versandt wird. Die Gültigkeit wird aufgrund dessen auf 24h erhöht.
Bei Fragen zur Konfiguration von Paymentkey wenden Sie sich bitte ein ihren Ansprechpartner bei CommDoo.
Hinweis zur noauth / nopreauth / paymentmode:
Bei Buchungsanfragen sendet SOG ERP keinen paymentmode für eine sofortige Buchung.
Bei Reservierungsanfragen sendet SOG ERP den paymentmode "reservation".
Nicht jedes Zahlungsmittel mit mit jeden Modus kompatibel.
siehe SchnittstellenZahlung
Falls von der Schnittstelle ein Fehler zurückgemeldet wird, wird dies im Slog und ggf. p105 als Fehler protokolliert. Dabei werden ggf. auch Fehlercodes und Beschreibungen protokolliert. Dass Fehler zurückgemeldet werden kann vielfältige Ursachen haben, die zudem je Schnittstelle und Zahlungsmittel unterschiedlich sind. Durch Analyse des Fehlercodes kann das Problem evtl. mit folgenden Ressourcen selbst nachvollzogen werden.
Fehlercodes, die mit "100017.1011.PC" beginnen, sind sogenanntente "Provider Codes", die vom Kreditkartennetzwerk zurückgemeldet werden.
-> https://docs.payengine.de/buildyourown/restdoc/providercodes
Andere Fehlercodes, die mit "100017.1011." anfangen, stehen im Zusammenhang mit der Kreditkartenabwicklung (Concardis PayEngine).
-> https://docs.payengine.de/buildyourown/restdoc/errors
Ansonsten sollte die Fehlerliste von CommDoo CommPay geprüft werden.
-> zahlungsschnittstellen.commdoo.errorlist
Bei der Nutzung anderer Zahlungsmittel (z.B. PayPal) können auch Fehlercodes der jeweiligen Anbieter übermittelt werden.
Häufige Fehlercodes / Lösungsansätze
"100017.1011.14200 (Bad value for 'initialAmount')" - Summenfehler, evtl. wurde die Autorisierung storniert oder es wird versucht, eine zu hohe Summe abzubuchen.
"100017.1011.PC.21 (No action taken)" - Die Kreditkarten-Autorisierung ist möglicherweise abgelaufen. Bitte prüfen und ggf. eine neue Autorisierung anfordern.
"10002310601" - Die Kreditkarten-Autorisierung ist möglicherweise abgelaufen. Bitte prüfen und ggf. eine neue Autorisierung anfordern.
Bitte beachten sie, dass die SOG keinen Einfluss auf die Fehlermeldungen der externen Schnittstelle hat. Die Angaben gelten somit ohne Gewähr.