# Integrar pagos con Datafast, PayPhone o Kushki en WooCommerce paso a paso

> Cómo integrar una pasarela de pago ecuatoriana (Datafast, PayPhone o Kushki) en WooCommerce: requisitos, pasos, pruebas, pago diferido y errores comunes.

URL: https://codegea.com/integrar-pagos-datafast-payphone-kushki-en-woocommerce
E-commerce · 2026-10-13 · Derian Pinto

Para vender en línea en Ecuador necesitas aceptar cómo paga la gente aquí: tarjetas locales, pago diferido y, en muchos casos, billeteras o transferencias. En WooCommerce eso se resuelve con una pasarela de pago conectada al checkout. Esta guía explica el proceso general para integrar Datafast, PayPhone o Kushki, qué preparar y cómo probarlo antes de cobrar un solo dólar.

Si todavía no has elegido pasarela, empieza por [Datafast vs PayPhone vs Kushki: qué pasarela elegir en Ecuador](/datafast-vs-payphone-vs-kushki-que-pasarela-elegir-en-ecuador). Aquí asumimos que ya decidiste y toca implementarla. Los pasos exactos y las credenciales dependen de cada proveedor y de su documentación vigente, que debes consultar siempre.

> Integrar una pasarela no es solo instalar un plugin: es configurar bien el cobro, probar los casos que fallan y asegurar que cada pago confirmado deje el pedido y la factura en orden.

## 1. Antes de empezar

- **Contrata la pasarela** con el proveedor: suele requerir RUC, datos del negocio y la información de tu sitio. Los tiempos de aprobación varían.
- **Pide credenciales de pruebas y de producción** (claves o identificadores y, según el proveedor, una URL de retorno y de notificación).
- **Verifica los requisitos de tu sitio:** certificado SSL activo y WooCommerce actualizado.
- **Confirma los métodos que habilita tu contrato:** tarjetas de crédito y débito, pago diferido (corriente o con intereses), billetera, transferencia.
- **Define las comisiones** y los plazos de acreditación para planificar tu flujo de caja.

## 2. Elegir el método de integración

Hay varias formas, y conviene saber cuál usas:

| Método | Cómo funciona | Para qué sirve |
| --- | --- | --- |
| Plugin oficial o de terceros | Se instala y se configura desde el panel | La vía más rápida cuando existe y cubre tus casos |
| Pasarela con redirección | El cliente paga en la página del proveedor y vuelve | Menos responsabilidad con datos de tarjeta |
| Formulario integrado | El pago ocurre dentro de tu checkout | Mejor experiencia, mayor cuidado de seguridad |
| Integración a medida | Se programa contra la API del proveedor | Casos que el plugin no cubre |

Si tu caso es particular, esto se vuelve una integración a medida, que es parte de lo que hacemos en nuestro servicio de [WooCommerce](/servicios/woocommerce).

## 3. Paso a paso general

1. **Instala el plugin** o el módulo de la pasarela desde una fuente confiable y revisa sus valoraciones y su última actualización.
2. **Configura el ambiente de pruebas** con las credenciales de prueba.
3. **Configura el método de pago** en WooCommerce: título, descripción, orden y países.
4. **Define las URLs de retorno y de notificación** que pide el proveedor, para que tu tienda reciba el resultado del pago.
5. **Activa el pago diferido,** si lo ofreces, con las opciones y plazos permitidos.
6. **Haz compras de prueba** con las tarjetas y datos que entrega el proveedor.
7. **Revisa el estado de los pedidos** tras cada prueba.
8. **Cambia a producción** con las credenciales reales y haz una compra real de bajo valor.

## 4. Casos que debes probar

No pruebes solo el pago exitoso. Prueba también:

- **Pago rechazado:** el mensaje debe ser claro y el carrito debe conservarse.
- **Pago cancelado** por el cliente en la página del proveedor.
- **Tiempo de espera agotado** o conexión perdida: ¿qué pasa con el pedido?
- **Pago diferido** con distintas cuotas.
- **Reembolsos** totales y parciales.
- **Cupones y envíos** mezclados con el cobro.
- **Notificaciones duplicadas:** el pedido no debe pasar a «pagado» dos veces.

## 5. Estados de pedido y notificaciones

El punto que más problemas da en producción es el **estado del pedido**. Asegúrate de que:

- Un pago confirmado cambia el pedido a «procesando» o «completado» según corresponda.
- Un pago fallido o expirado no deja pedidos «fantasma» sin resolver.
- Existe una **verificación del lado del servidor** (webhook o consulta), no solo la redirección del navegador, que el cliente puede interrumpir.

## 6. Factura electrónica

Cada pago confirmado debería terminar en un comprobante. Cuida que el checkout capture cédula o RUC y que la facturación se dispare cuando el pago se confirma, no antes. Lo explicamos en [facturación electrónica integrada](/facturacion-electronica-sri-integrada-a-tu-sistema-o-tienda).

## 7. Seguridad

- Mantén **WooCommerce, el tema y los plugins actualizados.**
- **No guardes datos de tarjeta** en tu sitio: la pasarela existe para evitarlo.
- Protege las claves de producción: fuera del repositorio y con acceso limitado.
- Mantén el sitio con HTTPS y un respaldo al día ([SSL, backups y firewall](/configurar-ssl-backups-y-firewall-en-tu-servidor)).

## 8. Errores comunes

- **Dejar el ambiente de pruebas activo** en producción (o al revés).
- **Confiar solo en el retorno del navegador** para marcar el pago.
- **No probar el rechazo,** y descubrir los fallos con clientes reales.
- **No ofrecer pago diferido,** que muchos compradores esperan.
- **Checkout lento o confuso:** lee los [errores de checkout que cuestan ventas](/errores-en-el-checkout-que-te-hacen-perder-ventas-en-ecuador).

## Qué incluimos en Codegea

Configuramos la pasarela, probamos los casos de rechazo y reembolso, conectamos la factura electrónica y dejamos el flujo documentado. Si tu tienda también necesita integraciones propias, lo vemos en el servicio de [tiendas online](/servicios/desarrollo-de-tiendas-online). Escríbenos desde [contacto](/contacto) y revisamos tu checkout.