VibeFox PagSeguro for PrestaShop

Übersicht

Das VibeFox PagSeguro Gateway verbindet PrestaShop über die PagBank Checkout API mit PagBank (früher PagSeguro). Im Zahlungsschritt wählt der Kunde PagBank; das Modul erstellt einen PagBank-Checkout über den genauen Warenkorbbetrag und leitet den Kunden auf die Zahlungsseite von PagBank weiter. Dort bezahlt er mit den in Ihrem PagBank-Konto aktivierten Zahlungsarten, etwa Kreditkarte, PIX oder Boleto, und kehrt danach in Ihren Shop zurück. Zahlungen werden nur in brasilianischen Real (BRL) angenommen. Die Bestellung wird erst angelegt, wenn PagBank die Zahlung bestätigt hat, sodass abgebrochene Zahlungen keine offenen Bestellungen hinterlassen.

Es eignet sich für brasilianische Shops, die die gehostete Zahlungsseite von PagBank mit Erstattungen direkt auf der Bestellseite nutzen möchten. Das Modul hat kein eigenes Kartenformular im Shop, keine gespeicherten Karten, keine Abonnements oder wiederkehrenden Zahlungen und keine Split-Zahlungen. Zahlungsarten und Ratenzahlungen werden in Ihrem PagBank-Konto festgelegt; im Modul werden sie nicht gewählt.

Hauptfunktionen

Gehostete PagBank-Seite: keine Kartendaten auf Ihrem Server. Name, E-Mail-Adresse, eine brasilianische Telefonnummer und CPF/CNPJ des Kunden werden auf der PagBank-Seite vorausgefüllt, wenn der Shop diese Daten hat.

Nur bezahlt, wenn PagBank es bestätigt: Benachrichtigungen und die Rückkehr des Kunden werden geprüft, indem Checkout und PagBank-Bestellung über die API gelesen werden: Status, Betrag in Centavos und Währung. Benachrichtigungen mit ungültiger Signatur werden abgelehnt.

Nichts in PagBank zu konfigurieren: Die Benachrichtigungs-URL wird bei jeder Zahlung übermittelt.

Betragsprüfung: Eine Zahlung, deren Betrag oder Währung nicht mit dem Warenkorb übereinstimmt, wird mit einer Notiz auf PagBank payment on hold gesetzt. Vom Käufer gezahlte Ratenzinsen werden berücksichtigt.

Klare Status: Bezahlte Bestellungen wechseln zu Payment accepted; erzeugte PIX- oder Boleto-Zahlungen und Zahlungen in Prüfung wechseln zu Awaiting PagBank payment; später abgelehnte Zahlungen wechseln zu Payment error, stornierte oder abgebrochene zu Canceled.

Keine doppelte Zahlung: Wer erneut zahlt, nutzt den offenen PagBank-Checkout wieder oder deaktiviert den vorherigen. Wiederholte Benachrichtigungen und Rücksprünge des Kunden erzeugen nie eine zweite Bestellung und verbuchen eine Zahlung nicht zweimal.

Sandbox und Produktion: getrennte Token. Statusprüfungen und Erstattungen einer Bestellung verwenden immer die Umgebung, in der ihre Zahlung erfolgt ist.

Erstattungen von der Bestellseite: vollständige und teilweise Erstattungen im Block PagBank payment, bis zu dem Betrag, den PagBank belastet hat, und nur verbucht, wenn PagBank sie bestätigt. Eine vollständige Erstattung setzt die Bestellung auf Refunded.

Anforderungen

PrestaShop 8.0 bis 9.x, PHP 8.0 oder neuer. Brasilianische Real (BRL) als Warenkorbwährung. Ein über HTTPS aus dem Internet erreichbarer Shop. Ein PagBank-Konto mit Produktionstoken und ein Sandbox-Token für Tests. Ein VibeFox-Lizenzschlüssel von vibefox.net (ein Schlüssel pro Domain).