VibeFox PagSeguro for OpenCart

Übersicht

VibeFox PagSeguro Gateway verbindet OpenCart 3 und OpenCart 4 mit der PagBank (PagSeguro) Checkout API für Shops in Brasilien. Im letzten Schritt des Bestellvorgangs klickt der Kunde auf Confirm Order, wird zur Zahlungsseite von PagBank weitergeleitet und bezahlt mit den in seinem PagBank-Konto aktivierten Zahlungsarten, zum Beispiel Kreditkarte, PIX oder Boleto. Zahlungen sind nur in brasilianischen Real (BRL) möglich. OpenCart legt die Bestellung vor der Zahlung an, doch die Bestellung erhält erst dann einen Status, wenn PagBank die Zahlung meldet; nicht bezahlte Versuche bleiben daher fehlende Bestellungen.

Die Erweiterung eignet sich für brasilianische Shops, die die gehostete Zahlungsseite von PagBank nutzen und Erstattungen direkt von der OpenCart-Bestellseite vornehmen möchten. Die Erweiterung hat kein Kartenformular im Shop, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen und keine Split-Zahlungen. Zahlungsarten und Ratenzahlungen richten sich nach Ihrem PagBank-Konto.

Hauptfunktionen

PagBank-Zahlungsseite: ein Checkout für die Bestellsumme in BRL. Die Zahlungsseite läuft nach 120 Minuten ab.

Nur bezahlt, wenn PagBank bestätigt: Benachrichtigungen und die Rückkehr des Kunden lösen lediglich eine Prüfung aus. Der Checkout, die PagBank-Bestellung und ihre Belastungen werden immer über die PagBank-API mit dem Token der Umgebung gelesen, in der die Zahlung erstellt wurde.

Signierte Benachrichtigungen: Wenn PagBank den Header x-authenticity-token sendet, wird er mit Ihrem Token geprüft; eine ungültige Signatur wird abgelehnt.

Prüfung von Betrag und Währung: der belastete Betrag (ohne Ratenzinsen von PagBank) und die Währung werden mit der Bestellung verglichen. Eine Abweichung oder eine Zahlung nach einer Stornierung setzt die Bestellung in einen Prüfstatus mit einer Notiz.

Boleto, PIX und Prüfung: ein erzeugtes Boleto oder PIX oder eine Zahlung in Prüfung setzt die Bestellung in einen Wartestatus, bis PagBank die Zahlung als bezahlt meldet.

Ein Warenkorb, eine Zahlung: Wenn der Kunde erneut zahlt, wird der offene PagBank-Checkout wiederverwendet oder zuvor deaktiviert. Eine Zahlung auf einer älteren Seite zählt weiterhin, und eine zweite Zahlung wird zur Erstattung markiert.

Erstattungen über die Bestellseite: vollständige und teilweise Erstattungen im Reiter VibeFox PagSeguro Gateway der Bestellung, bis zu dem Betrag, den PagBank tatsächlich belastet hat. Im PagBank-Dashboard vorgenommene Erstattungen werden in der Bestellung vermerkt.

Sandbox und Produktion: getrennte Token. Statusabfragen und Erstattungen verwenden immer die Umgebung der Zahlung. Eigene OpenCart-Bestellstatus für jeden Fall.

Anforderungen

OpenCart 3.0.x (getestet mit 3.0.5.0) oder OpenCart 4.0.2 und neuer (getestet mit 4.1.0.3), PHP 8.0 oder neuer. Der Download enthält die Pakete für beide Versionen. Die Währung Brasilianischer Real (BRL) in Ihrem Shop. Ein PagBank-Konto mit einem Produktionstoken und für Tests ein Sandbox-Token. Ein VibeFox-Lizenzschlüssel von vibefox.net (ein Schlüssel pro Domain).