Ir al contenido principal

ArtinTech Solution

Gateway payments list in Linkhive

El navegador de un cliente que vuelve de una página de pago no demuestra nada, porque cualquiera puede escribir esa URL. Para verificar una pasarela de pago en Laravel correctamente, trata el retorno como un indicio y pregunta a la pasarela qué ocurrió de verdad. Así lo construimos en Linkhive, nuestra plataforma de facturación para ISP.

Una interfaz pequeña

Cada pasarela implementa dos métodos: checkout() devuelve la URL a la que enviar al cliente y verify() devuelve un pago verificado o null. Los controladores nunca leen importes de la petición. Solo pasan un resultado verificado al servicio de facturación.

Qué comprueba la verificación de Stripe

Al iniciar una sesión de Checkout guardamos su ID y el importe exacto en nuestra fila de pago. Al volver, el código rechaza la petición si el ID de sesión no coincide, y luego consulta la sesión en Stripe y compara:

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

Cada comprobación cierra un ataque real: reutilizar la sesión de otro cliente, pagar menos o pagar en una moneda más barata.

Lista de pagos de Linkhive con método, referencia, importe, transferencias pendientes y pagos completados
Los pagos por pasarela se completan solos. Las transferencias esperan la aprobación.

Aplicar el dinero una sola vez

Un pago verificado llega a approvePayment(), que bloquea la fila dentro de una transacción. Si llegan dos retornos a la vez, el segundo encuentra el pago ya completado y no hace nada. Un pago marcado como fallido por el navegador aún puede completarse si la pasarela lo confirma después.

Ideas clave

  • Trata las URL de retorno como indicios y confirma con la API de la pasarela.
  • Compara sesión, referencia, importe y moneda.
  • Bloquea la fila del pago para que los retornos repetidos sean inofensivos.

Prueba el flujo en la demo en vivo de Linkhive o consigue Linkhive en Vibe96. ¿Necesitas integrar pasarelas en tu app Laravel? Hablemos, o consulta nuestro desarrollo Laravel.

Share this article