Passer au contenu principal

ArtinTech Solution

Gateway payments list in Linkhive

Le navigateur d’un client qui revient d’une page de paiement ne prouve rien, car n’importe qui peut saisir cette URL. Pour vérifier une passerelle de paiement dans Laravel correctement, traitez le retour comme un indice et demandez à la passerelle ce qui s’est réellement passé. Voici comment nous l’avons construit dans Linkhive, notre plateforme de facturation pour FAI.

Une petite interface

Chaque passerelle implémente deux méthodes : checkout() renvoie l’URL vers laquelle envoyer le client, et verify() renvoie un paiement vérifié ou null. Les contrôleurs ne lisent jamais de montant dans la requête. Ils transmettent seulement un résultat vérifié au service de facturation.

Ce que contrôle la vérification Stripe

Au démarrage d’une session Checkout, nous enregistrons son identifiant et le montant exact sur notre ligne de paiement. Au retour, le code rejette la requête si l’identifiant ne correspond pas, puis récupère la session chez Stripe et compare :

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;
}

Chaque contrôle ferme une attaque réelle : rejouer la session d’un autre client, payer un montant inférieur ou payer dans une devise moins chère.

Liste des paiements Linkhive avec moyen, référence, montant, virements en attente et paiements terminés
Les paiements par passerelle se terminent seuls. Les virements attendent une validation.

Appliquer l’argent une seule fois

Un paiement vérifié arrive à approvePayment(), qui verrouille la ligne dans une transaction. Si deux retours arrivent ensemble, le second trouve le paiement déjà terminé et ne fait rien. Un paiement marqué en échec par le navigateur peut encore aboutir si la passerelle le confirme plus tard.

À retenir

  • Traitez les URL de retour comme des indices et confirmez via l’API de la passerelle.
  • Comparez session, référence, montant et devise.
  • Verrouillez la ligne de paiement pour rendre les retours répétés inoffensifs.

Essayez le parcours dans la démo en ligne de Linkhive ou obtenez Linkhive sur Vibe96. Besoin d’intégrer des passerelles à votre application Laravel ? Parlons-en, ou découvrez notre développement Laravel.

Share this article