Tarjetas, wallets y métodos de pago locales con un solo proveedor: así integra Stripe en Shopware 6 para su tienda en España, mediante el plugin oficial o la API, con webhooks, tarjetas de prueba y puesta en marcha.
Que su tienda acepte pagos de forma fluida y segura no es negociable. Esta guía lleva a responsables de tiendas online en España y a desarrolladores hacia una integración sólida de Stripe en Shopware 6. Aprenderá:
En nuestra visión general de integraciones de pago para Shopware verá qué otros proveedores puede conectar.
Stripe es una plataforma para aceptar pagos online: compras únicas, suscripciones o pagos a vendedores de un marketplace. Más allá del pago con tarjeta, Stripe ofrece:
Para tiendas headless o procesos muy personalizados:
stripe/stripe-php con Composer, crear PaymentIntents, confirmar pagos y gestionar suscripciones.payment_intent.succeeded, invoice.payment_failed o charge.refunded y actualizar el estado del pedido en Shopware.Desarrollamos integraciones propias como plugin o app de Shopware; consulte desarrollo de plugins para Shopware.
Si gestiona las extensiones con Composer, obtenga el paquete a través de su cuenta de Shopware y actívelo después:
bin/console plugin:refresh
bin/console plugin:install --activate StripeShopwarePayment
bin/console cache:clear
El nombre técnico exacto lo muestra bin/console plugin:list.
pk_test_ y sk_test_).payment_intent.succeeded, payment_intent.payment_failed, charge.refunded y, si usa suscripciones, invoice.payment_succeeded.whsec_…) en la configuración del plugin.Muchas versiones del plugin crean el endpoint automáticamente. Compruebe en el Dashboard que existe y que apunta al modo correcto.
A continuación, active los métodos de pago en Configuración → Tienda → Métodos de pago y asígnelos a los canales de venta.
4242 4242 4242 4242, cualquier fecha de caducidad futura y cualquier código de seguridad.Con el Payment Element, Stripe muestra todos los métodos de pago activados en un único formulario directamente en su checkout. La estructura básica en una integración propia:
<form id="payment-form">
<div id="payment-element"></div>
<button id="submit">Pagar ahora</button>
</form>
const stripe = Stripe('pk_test_SU_CLAVE');
// clientSecret procede del PaymentIntent que ha creado su servidor
const elements = stripe.elements({ clientSecret });
const paymentElement = elements.create('payment');
paymentElement.mount('#payment-element');
document.getElementById('payment-form').addEventListener('submit', async (e) => {
e.preventDefault();
const { error } = await stripe.confirmPayment({
elements,
confirmParams: { return_url: 'https://su-tienda.es/checkout/finish' }
});
if (error) { console.error(error.message); }
});
El plugin de Shopware realiza esta integración por sí mismo; el código solo es relevante si construye un checkout propio.
4242 4242 4242 42424000 0000 0000 00024000 0000 0000 99954000 0025 0000 3155pk_live_, sk_live_) en la configuración del plugin.Stripe envía una notificación con cada evento importante. Los más habituales:
payment_intent.succeeded: marcar el pedido como pagado y enviar la confirmación.payment_intent.payment_failed: informar al cliente y ofrecerle otro método de pago.charge.refunded: poner el pedido en “reembolsado” y enviar el justificante.invoice.payment_succeeded: renovar la suscripción y enviar el recibo.$payload = file_get_contents('php://input');
$signature = $_SERVER['HTTP_STRIPE_SIGNATURE'] ?? '';
try {
$event = \Stripe\Webhook::constructEvent($payload, $signature, $webhookSecret);
} catch (\Exception $e) {
http_response_code(400);
exit;
}
switch ($event->type) {
case 'payment_intent.succeeded':
$this->markOrderPaid($event->data->object->metadata->order_id);
break;
case 'payment_intent.payment_failed':
$this->notifyCustomer($event->data->object->metadata->order_id);
break;
}
http_response_code(200);
Compruebe siempre la firma, responda rápidamente con 200 y procese el evento de forma idempotente, porque Stripe repite los envíos. Cómo gestiona Shopware los webhooks lo explicamos en nuestro artículo sobre webhooks en Shopware 6.
var/log/ en busca de excepciones.stripe listen --forward-to https://su-tienda.test/stripe/webhookCon Stripe Checkout o Elements, es Stripe quien procesa los datos de tarjeta, no su servidor. Sirva las páginas de checkout exclusivamente por HTTPS y no registre nunca datos completos de tarjetas.
Active las reglas estándar de Radar, revise con regularidad los pagos marcados y ajuste los límites ante patrones sospechosos. Utilice 3D Secure: en Europa, incluida España, la autenticación reforzada de clientes (SCA) es obligatoria de todos modos por la Directiva PSD2.
Añada el número de pedido, el ID de cliente y el importe del carrito como metadatos a cada PaymentIntent. Así podrá conciliar los pagos sin ambigüedad entre Stripe y la contabilidad.
¿Cómo cambio las claves de API sin dejar la tienda fuera de servicio?
El plugin mantiene en paralelo las claves de test y de live; introduzca las nuevas claves y cambie de modo con el interruptor. En integraciones propias, aplique el cambio en un momento de poco tráfico.
¿Puedo ofrecer pago a plazos?
Sí. Active en el Dashboard de Stripe, en Métodos de pago, opciones de “compra ahora, paga después” como Klarna y habilítelas después en el plugin.
¿Cómo funcionan los reembolsos?
Los reembolsos completos se inician desde el pedido en Shopware; el plugin llama a la API de Stripe. Los reembolsos parciales se realizan en el Dashboard de Stripe o por API indicando el importe. Si un cliente ejerce su derecho de desistimiento de 14 días, tenga en cuenta el plazo legal para devolverle el pago.
¿Cuánto cuesta Stripe?
Según la página de precios de Stripe para España, la tarifa estándar para tarjetas del Espacio Económico Europeo es del 1,5 % más 0,25 € por transacción; las tarjetas internacionales y la conversión de divisas cuestan más. Consulte las condiciones vigentes en stripe.com.
¿Qué métodos de pago complementan bien a Stripe en España?
Sobre todo PayPal y Amazon Pay, además de Bizum a través de un proveedor que lo admita. Nuestro análisis de tienda le muestra dónde pierde clientes su checkout.