Zum Hauptinhalt springen

ArtinTech Solution

Gateway payments list in Linkhive

Der Browser eines Kunden, der von einer Zahlungsseite zurückkehrt, beweist nichts, denn diese URL kann jeder eintippen. Um ein Zahlungs-Gateway in Laravel korrekt zu prüfen, behandeln Sie die Rückkehr als Hinweis und fragen den Anbieter, was wirklich passiert ist. So haben wir es in Linkhive gebaut, unserer ISP-Abrechnungsplattform.

Eine kleine Schnittstelle

Jedes Gateway implementiert zwei Methoden: checkout() liefert die URL für den Kunden, verify() eine geprüfte Zahlung oder null. Controller lesen nie Beträge aus der Anfrage. Sie reichen nur ein geprüftes Ergebnis an den Abrechnungsdienst weiter.

Was die Stripe-Prüfung kontrolliert

Beim Start einer Checkout-Session speichern wir ihre ID und den exakten Betrag in unserer Zahlungszeile. Bei der Rückkehr lehnt der Code die Anfrage ab, wenn die Session-ID nicht passt, ruft dann die Session bei Stripe ab und vergleicht:

if (($session['payment_status'] ?? null) !== 'paid'
    || ($session['client_reference_id'] ?? null) !== $payment->number
    || (int) ($session['amount_total'] ?? -1) !== $expected
    || ! self::sameCurrency($payment, $session['currency'] ?? null)) {
    return null;
}

Jede Prüfung schließt einen echten Angriff: die Sitzung eines anderen Kunden wiederverwenden, einen kleineren Betrag zahlen oder in einer billigeren Währung zahlen.

Linkhive Zahlungsliste mit Methode, Referenz, Betrag, ausstehenden Überweisungen und abgeschlossenen Gateway-Zahlungen
Gateway-Zahlungen schließen sich selbst ab. Überweisungen warten auf die Freigabe.

Das Geld nur einmal verbuchen

Eine geprüfte Zahlung geht an approvePayment(), das die Zeile in einer Transaktion sperrt. Treffen zwei Rückmeldungen gleichzeitig ein, findet die zweite die Zahlung bereits abgeschlossen und tut nichts. Eine vom Browser als fehlgeschlagen markierte Zahlung kann trotzdem abgeschlossen werden, wenn das Gateway sie später bestätigt.

Die wichtigsten Punkte

  • Behandeln Sie Rückkehr-URLs als Hinweise und bestätigen Sie über die Gateway-API.
  • Vergleichen Sie Sitzung, Referenz, Betrag und Währung.
  • Sperren Sie die Zahlungszeile, damit wiederholte Rückmeldungen harmlos bleiben.

Testen Sie den Ablauf in der Linkhive Live-Demo oder holen Sie sich Linkhive auf Vibe96. Brauchen Sie Gateways in Ihrer eigenen Laravel-App? Sprechen wir darüber, oder sehen Sie sich unsere Laravel-Entwicklung an.

Share this article