Dieser Artikel beschreibt die Änderungen der collana pay App, veröffentlicht am 16.11.2026. Die Änderungen sind in folgenden Versionen enthalten:
- v29:
29.0.2611.2701 - v28:
28.0.2611.2706 - v27:
27.0.2611.2713 - v26:
26.0.2611.2715
Fehlerbehebungen
Transaktionen – Kein Reversal nach einem Cart Update, dessen Betrag vollständig eingezogen wurde
Nach einem Cart Update wird der verbleibende reservierte Betrag jetzt aus dem aktualisierten Warenkorb berechnet statt aus der ursprünglichen Reservierung.
- Wird der aktualisierte Warenkorb vollständig eingezogen, wird kein Reversal mehr gestartet. Bisher wurde ein Reversal für die Differenz zur ursprünglichen Reservierung gestartet und von collana pay abgelehnt (
no reserved amount). - Wird nur ein Teil des aktualisierten Warenkorbs eingezogen, wird der Rest weiterhin freigegeben.
- Derselbe Betrag gilt jetzt auch für die Aktion Reversal Amount, die Verlängerung der Reservierung und die Rückfrage beim Archivieren einer Transaktion.
Notifications – Status „Retry“ verarbeitet Notifications, deren Erstverarbeitung zurückgerollt wurde
Es kann vorkommen, dass der erste Verarbeitungslauf einer Notification zurückgerollt wird und die Kopffelder leer bleiben. Wird eine solche Notification auf Retry gesetzt, durchläuft sie die Erstverarbeitung jetzt erneut. Bisher lief sie mit Missing transaction log no. auf Fehler.
Eine Notification, die nach dem ersten erfolgreichen Lauf auf Retry gesetzt wird, wird wie bisher ohne Wiederholung der Erstverarbeitung fortgesetzt.
Transaktionen – Artikelliste einer extern angelegten Transaktion wird bei der Statusverarbeitung aus den aktuellen Verkaufszeilen aufgefrischt
Wurde ein Auftrag mit einer im Shop gestarteten Zahlung freigegeben, bevor alle Verkaufszeilen angelegt waren (zum Beispiel durch einen Job), wurde die Artikelliste der collana pay Transaktion aus den bis dahin vorhandenen Zeilen aufgebaut. Danach wurde sie nicht mehr aktualisiert. Die Folgen:
- Die Statusbenachrichtigung konnte die vom Zahlungsdienstleister gemeldeten Positionen nicht zuordnen (
Item not found). - Der
STATUS-Logeintrag blieb ausstehend und der Auftrag blockiert. - Je nach Version wurde die Benachrichtigung zusätzlich als
No matching transaction foundstorniert.
Die Statusverarbeitung baut die Artikelliste jetzt aus den aktuellen Verkaufszeilen neu auf. Das gilt, solange die Transaktion ausschließlich Statuseinträge hat und noch keiner Position eine Interaktion zugeordnet wurde. Hängende Benachrichtigungen werden beim nächsten Lauf verarbeitet, sobald der Auftrag vollständig ist.
Von Business Central gesendete Warenkörbe (Import, Reservierung, Cart Update) bleiben unverändert.
Transaktionen – Freigabeprüfungen verwenden den Betrag des letzten Cart Updates
Nach einem erfolgreichen Cart Update verwenden die Betragsprüfungen bei der Freigabe jetzt den aktualisierten Warenkorb statt der ursprünglichen Reservierung. Für Transaktionen ohne Cart Update ändert sich an der Freigabe nichts.
Freigabe
- Nach einem Teileinzug wird die Freigabe jetzt abgelehnt, wenn der offene Auftragsbetrag den Rest des aktualisierten Warenkorbs übersteigt. Bisher wurde der offene Betrag mit der ursprünglichen Reservierung verglichen, sodass erst der Einzug beim Zahlungsdienstleister fehlschlug.
- Die Freigabe wird ebenfalls abgelehnt, wenn die Artikelliste der Transaktion nach einem Cart Update manuell neu aufgebaut wird und den aktualisierten Warenkorb übersteigt.
MwSt.-Aktualisierung
Auch die MwSt.-Aktualisierung einer Transaktion verwendet den aktualisierten Warenkorb. Ist dieser vollständig eingezogen, wird jetzt gemeldet, dass nichts zu aktualisieren ist. Dasselbe gilt, wenn alle Artikel des Warenkorbs bereits eingezogen sind. Bisher wurde eine Anfrage vorbereitet, obwohl nichts mehr zu aktualisieren war.
Anzeige in Transaktionsliste und Infobox
- Die Spalte Reserved Amount der Transaktionsliste zeigt jetzt den Betrag des aktualisierten Warenkorbs.
- In der Infobox Summary zeigt die Zeile
UPDATEjetzt den Betrag des letzten Cart Updates statt der Summe aller Cart Updates. Die ZeileRESERVEzeigt weiterhin die ursprüngliche Reservierung.
Artikelliste der Transaktion
Rebuild List und Show Differences verwenden jetzt zuerst die Artikel des letzten Cart Updates. Die Artikel der Reservierung werden nur noch für Zeilen verwendet, die das Cart Update nicht enthält. Bisher erhielt eine Zeile, deren Menge per Cart Update geändert wurde, beim Neuaufbau der Liste keine Cart Item ID.
Simulation
In der Simulation berechnet das Szenario Void des erweiterten Status den verbleibenden reservierten Betrag jetzt aus dem aktualisierten Warenkorb.
Verbesserungen & Erweiterungen
Transaktionen – Status Advanced: Abgleich mit dem Zahlungsdienstleister, Zuordnung PSP-seitiger Interaktionen und Simulationsszenarien
Neue Aktion: Auftragsstatus abrufen (Advanced)
Die Transaktionskarte hat im Status-Splitbutton eine neue Aktion Auftragsstatus abrufen (Advanced). Anders als beim normalen Status fragt collana pay dabei den Zahlungsdienstleister ab und gleicht die Transaktion ab:
- Interaktionen, die Business Central gestartet hat, die aber fehlgeschlagen sind oder nie abgeschlossen wurden, werden als fehlgeschlagen gemeldet.
- Direkt im PSP-Backend ausgeführte Captures, Erstattungen, Stornierungen und Chargebacks werden als neue Interaktionen zurückgeliefert.
- Die Aktion ist für wiederkehrende Zahlungen nicht verfügbar.
- Der
STATUS-Logeintrag behält seinen Funktionscode und wird mit dem neuen Feld Status Advanced markiert.
Abgleich des Logs
Im Advanced-Modus überschreibt das gemeldete PSP-Ergebnis jeden Logeintrag. Das gilt auch für Einträge, die auf OK - Manuell gesetzt wurden. Ausgenommen sind nur Einträge im Status NOK Checked.
Meldet collana pay eine Interaktion ohne Gegenstück in Business Central, sucht die App einen „Spender“. Das ist ein manueller oder fehlgeschlagener Eintrag derselben Funktion mit demselben Betrag.
- Der neue Eintrag übernimmt Referenznr., Debitorenposten und Positionen des Spenders.
- Der Spender wird mit Status
NOKund StatuscodeSUPERSEDEDgeschlossen und nie wieder zugeordnet.
Ersetzte Einträge zählen nicht mehr als fehlgeschlagene Kommunikation:
- Die Fehler-Kacheln ignorieren sie.
- Auf OK - Manuell setzen, Logeintrag auf Ausgesetzt setzen und Reversal wiederholen sind für sie gesperrt.
- Die manuellen Funktionen der Transaktionskarte senden sie nicht erneut.
- Sie blockieren das Löschen eines Belegs nicht.
Für den Abgleich gilt außerdem:
- Ein Capture über den kompletten Warenkorb übernimmt den Warenkorb als Positionen. Es setzt das Capture-Timing auf Release und zieht die Debitorenposten bereits gebuchter Rechnungen nach.
- Stornierungen werden wie Captures und Erstattungen behandelt.
- Im Advanced-Status gelistete Chargebacks erzeugen oder aktualisieren den
CHARGEBACK-Logeintrag zum zugehörigen Capture. - Capture- und Erstattungs-Timing der Transaktion werden auf die Werte der Einrichtungszeile zurückgesetzt, sobald zwei Bedingungen erfüllt sind: Es existiert kein manueller Eintrag mehr, und der jeweils neueste Eintrag je Beleg und Funktion ist erfolgreich. Release wird nie überschrieben.
- Jede Änderung wird im erweiterten Log mit einer blauen Zeile dokumentiert.
Manuelle Zuordnung
Ein Capture, eine Erstattung oder Gutschrift ohne Spender und ohne Treffer auf den kompletten Warenkorb wird mit Manuelle Zuordnung erforderlich und einer roten Zeile markiert. Die Markierung steuert:
- eine neue Kachel in den Aktive-Transaktionen-Cues
- ein Zählfeld auf Transaktionskarte und -liste mit Drilldown
- die Aktion Beleg zuordnen auf den Transaktionslog-Seiten und im erweiterten Log
Beleg zuordnen öffnet ein Arbeitsblatt mit den Warenkorbzeilen bzw. den Positionen des erstatteten Captures. Es ist mit den Restmengen oder den Mengen eines gewählten gebuchten Belegs vorbelegt.
- Mengen, Zeilenrabatt und Betrag inkl. MwSt. lassen sich bearbeiten, bis die Zeilen den vom PSP gemeldeten Betrag ergeben.
- Transaktionen ohne Warenkorb erhalten ihre Zeilen aus dem Beleg.
- Für eine Erstattung ohne Rückgabebeleg erstellt das Arbeitsblatt in einem Schritt eine Verkaufsgutschrift oder -reklamation. Grundlage ist die gebuchte Rechnung des Captures mit den erstatteten Zeilen. Der Eintrag wird dabei zugeordnet. Anschließend bietet die App an, den erstellten Beleg sofort zu öffnen.
- Einträge, die einem ungebuchten Beleg zugeordnet wurden, werden beim Buchen vom gebuchten Beleg übernommen. So fordert die Buchung kein zweites Capture bzw. keine zweite Erstattung an.
- Ein zugeordneter Erstattungs- oder Gutschrifteintrag wird erkannt, unabhängig davon, ob der Beleg als Erstattung oder Gutschrift bucht (Advanced Import, Force Credit).
Dieselbe Markierung erhalten Interaktionen von Advanced-Import-Transaktionen, die ein normaler Status ohne Beleg meldet.
Automatische Zuordnung
Das neue Einrichtungsfeld Status Advanced: automatische Zuordnung ist standardmäßig aktiv, auch für bestehende Mandanten. Es ordnet eine solche Interaktion automatisch zu, wenn die Transaktion genau eine gebuchte Rechnung bzw. gebuchte Gutschrift hat, deren Betrag und Zeilen passen. Die Zeilen einer unterbrochenen Buchung werden dabei einbezogen.
- Ohne eindeutigen Treffer wird der Eintrag zur manuellen Zuordnung markiert.
- Ein Eintrag, dessen gemeldeter Betrag von seinen Positionen abweicht, wird ebenfalls markiert. Positionen werden nie skaliert.
Simulation
Eine Einrichtungszeile im Modus Simulation mit angeforderter Antwort fragt beim simulierten Advanced-Status nach einem Szenario:
- fehlgeschlagenes BC-Capture durch ein PSP-Capture ersetzt
- Capture über den kompletten Warenkorb, die erste Zeile oder den Restbetrag
- Erstattung, Stornierung oder Chargeback des letzten Captures
- ein mit niedrigerem Betrag gemeldetes Capture
- Capture, Erstattung oder Gutschrift des Belegs, von dem der Status gestartet wurde
Je Aufruf ist ein Szenario möglich. Ein Publisher erlaubt automatisierten Tests, ein Szenario ohne Dialog vorzugeben. Die simulierten Restbeträge folgen der PSP-Sicht: Auf OK - Manuell gesetzte Einträge reduzieren sie nicht.
Erstattungsprüfung beim Buchen
Die Erstattungsprüfung beim Buchen vergleicht jetzt mit der Währungsgenauigkeit statt exakt.
Hinweis für Partner:
Partner, die die Belegzuordnung selbst kennen (z. B. Advanced Import), können Einträge darüber zuordnen oder die Markierung setzen. |
Upgrade-Hinweis
Datenupgrade: Das neue Einrichtungsfeld Status Advanced: automatische Zuordnung wird für bestehende Mandanten aktiviert.
Recurring Payments – Zahlungsanbieter-Referenz am Mandat
Neues Feld Zahlungsanbieter-Referenz
Das collana pay Mandat hat jetzt ein Feld Zahlungsanbieter-Referenz (Provider Reference) auf Mandatskarte und -liste. Es entspricht der collana pay Zahlungsanbieter-Referenz an Verkaufsauftrag und Verkaufsrechnung.
- Beim Anlegen oder Importieren eines Mandats wird das Provider Account Mapping mit dieser Referenz ermittelt. So kann bei einer Zahlungsart mit mehreren Provider-Konten das Konto je Mandat gewählt werden.
- Ein aus einem Verkaufsauftrag erzeugtes Mandat übernimmt die Referenz des Auftrags.
- Bei der Suche eines aktiven Mandats für einen wiederkehrenden Auftrag bzw. eine Rechnung wird die Referenz ebenfalls berücksichtigt:
- Ein Mandat ohne Referenz passt zu jedem Beleg.
- Ein Mandat mit Referenz passt nur zu Belegen mit derselben Referenz.
- Ein Mandat mit exakt passender Referenz wird gegenüber einem ohne Referenz bevorzugt.
- Die manuelle Zuordnung eines Mandats zu einer Transaktion, deren Beleg eine abweichende Referenz trägt, wird mit einer Fehlermeldung abgelehnt.
- Eine Provider-Account-Zuordnung ohne Zahlungsland löscht das Zahlungsland der Transaktion nicht mehr. Dadurch funktioniert die Mandatsauswahl auch für Belege mit einer solchen Zuordnung.
Aus Business Central gestartete Zahlungen bei aktiviertem Use embedment
Wird eine Zahlung aus Business Central gestartet (Zahlungslink oder wiederkehrende Zahlung / Mandatsanlage), muss collana pay einen Zahlungslink (RedirectUri) liefern. Ist am Provider-Konto der Zahlung in copal Use embedment aktiviert (eingebettete Checkouts, z. B. Webshops), liefert collana pay stattdessen einen Embedded Checkout (EmbedmentUri). Dieser kann aus Business Central nicht genutzt werden. Bisher blieb der RESERVE- bzw. PREPARE-Logeintrag in diesem Fall ohne Hinweis ausstehend.
- Eine solche Pending-Notification setzt den Logeintrag jetzt auf
NOKmit StatuscodeFAILEDund die Transaktion auf Declined. Der Fall erscheint damit auf der Kachel Failed/declined RESERVE. - Ein roter Extended-Log-Eintrag (Setup Error) erklärt, dass die Interaktion bei collana pay nicht fehlgeschlagen ist, aber aus Business Central nicht abgeschlossen werden kann. Er benennt die Ursache (Use embedment am Provider-Konto in copal). Außerdem empfiehlt er eine von zwei Lösungen und danach das Anlegen einer neuen Transaktion:
- ein Provider-Konto ohne Use embedment zuordnen
- die Einstellung in copal abschalten
- Zahlungen, die nicht aus Business Central gestartet werden (Webshop-Checkouts), sind nicht betroffen.