Saltar al contenido principal

Stripe

Instrucciones para conectar Stripe​

Cree una cuenta de pago con tipo Stripe​

Cómo crear una cuenta de pago se describe aquí (se abre en una pestaña nueva).

Conecte Stripe a la cuenta de pago​

Para ello, dirígete a la cuenta de pago creada y haz clic en Conectar Stripe.

Formulario de edición de la cuenta de pago stripe, una flecha señala el botón "Connect Stripe" bajo la casilla "Test mode"

Serás redirigido a la página de conexión de Stripe. Completa los datos de la empresa, selecciona el tipo y la ubicación del negocio, confirma al representante de la cuenta e indica los datos bancarios para los pagos. Una vez que completes el registro, regresarás al CMS y la cuenta de pago mostrará el estado Stripe conectado.

Después de conectar, ve a Desarrolladores → Webhooks en el panel de control de Stripe y haz clic en Agregar destino.

Sigue los pasos del asistente para crear un destino de evento: selecciona los eventos que deseas escuchar, elige el tipo de destino (punto final de webhook), y en el paso de configuración, en el campo Endpoint URL, indica la dirección de nuestro webhook. Reemplaza test-project.oneentry.cloud con la dirección de tu proyecto:

https://test-project.oneentry.cloud/api/content/payments/webhook/stripe

Asigna un nombre al destino y completa la creación: el nuevo punto final aparecerá en la lista de destinos de eventos con el estado Activo.

Para que OneEntry verifique la autenticidad de los eventos que llegan de Stripe, copia el secreto de firma (Signing secret) del punto final creado en el panel de control de Stripe. Lo necesitarás en la configuración de la cuenta de pago.

Después de agregar el webhook, ve al CMS en Pagos → Estados, selecciona el almacén de pedidos y accede a su configuración.

Pestaña "Statuses" de "Payments": la tabla muestra "Order Storage 1" con el marcador storage1 y un icono de configuración

Agregue la actualización automática del estado de pago para el pedido. A la izquierda se muestran los estados de pago, y a la derecha los estados de sus pedidos, añadidos anteriormente en la sección de pedidos: elija qué estado recibe el pedido con cada estado de pago.

Pantalla "Payment Status Settings": estados de pago "Waiting", "Completed", "Canceled", "Payment has expired" asociados a estados del pedido, botón "Save"

Completa la configuración de la cuenta​

Abre la cuenta de pago para editar. En el bloque Detalles, indica:

  • Success URL — la dirección a la que el comprador regresará después de un pago exitoso. Este campo es obligatorio.
  • Cancel URL — la dirección a la que el comprador regresará si cancela el pago.
  • Session timeout — el tiempo de vida de la sesión de pago. El valor debe ser un número entero mayor que 0.
  • Use Stripe webhook data validation — habilita la verificación de autenticidad de los datos que Stripe envía al webhook.
  • Key for validating Stripe webhook — secreto de firma del punto final en el panel de control de Stripe. Este campo se vuelve accesible solo cuando está marcada la opción Use Stripe webhook data validation, y en ese caso es obligatorio.

Los cambios se guardan automáticamente.

Bloque "Details" de la cuenta de pago stripe: una flecha señala los campos "Success URL" y "Cancel URL"

En la cuenta de pago hay soporte para el modo de prueba. Esta función permite probar la conexión de Stripe con parámetros de conexión de prueba.

Cuenta de pago stripe: una flecha señala la casilla "Testing mode" sin marcar sobre el botón "Connect Stripe"

Para desactivar el modo de prueba, desmarca la casilla.