Cómo integrar PayPhone en WooCommerce paso a paso

Lo que cobra PayPhone

Según su página del botón de pago, PayPhone cobra una comisión fija del 5 % más IVA solo cuando cobras, sin costo de activación ni mensualidad, y acredita el dinero al instante. Acepta Visa, Mastercard, Diners Club y Discover, además del saldo de la app PayPhone.

Para tener la cifra clara: en una venta de 100 dólares, la comisión es de 5 dólares más el IVA de esos 5 dólares. Si comparas con una pasarela que cobra mensualidad, haz la cuenta con tus ventas reales: con volúmenes bajos, no pagar mensualidad suele compensar un porcentaje más alto.

Antes de empezar: los cuatro requisitos

La documentación de PayPhone pide cuatro cosas. Conviene tenerlas antes de tocar WordPress:

1. 1 WooCommerce instalado sobre WordPress, con la moneda de la tienda en dólares.
2. 2 HTTPS con un certificado SSL activo. Sin él, la integración no funciona fuera de una instalación local de pruebas.
3. 3 Una cuenta PayPhone Business activa, a nombre de tu negocio.
4. 4 Un usuario con el rol «Desarrollador» en PayPhone Business. Es el que puede crear la aplicación que genera las credenciales. Si quien configura la tienda es tu proveedor, dale ese rol a su usuario en lugar de compartir tu contraseña.

Paso 1: crear la aplicación y obtener el token

Las credenciales no están en PayPhone Business, sino en PayPhone Developer:

1. 1 Entra a PayPhone Developer con el usuario que tiene el rol Desarrollador.
2. 2 Crea una aplicación de tipo «WEB».
3. 3 Completa el Dominio Web con el dominio de tu tienda y la URL de Respuesta. Esta última la da el propio plugin: la verás en el paso 3, así que puedes volver a completarla después.
4. 4 Al guardar, PayPhone genera el Token (un Bearer Token) y el Store ID.

Trata el token como una contraseña: quien lo tenga puede cobrar en nombre de tu tienda.

Paso 2: instalar el plugin

En WordPress, ve a Plugins → Añadir nuevo, busca «payphone», instala el plugin y actívalo.

Paso 3: configurar PayPhone en WooCommerce

1. 1 Ve a WooCommerce → Ajustes → Pagos.
2. 2 Busca el método «Tarjetas de crédito o débito Visa, MasterCard, Diners Club, Discover | Payphone» y pulsa Gestionar.
3. 3 Pega el Token que obtuviste en PayPhone Developer.
4. 4 Escribe el StoreID. Según la documentación, es opcional si tienes una sola tienda.
5. 5 Marca Habilitar para que aparezca en el checkout.
6. 6 Copia la URL de respuesta que muestra esta pantalla y pégala en la aplicación que creaste en PayPhone Developer.

Ese último paso es el que más se olvida, y sin él el pago se hace pero la tienda no se entera: el cliente paga y el pedido queda pendiente.

Paso 4: probar sin cobrar de verdad

PayPhone tiene dos entornos. En el entorno de pruebas, todas las transacciones se aprueban y no hay cargos reales; se revisan en PayPhone Developer. En producción, el dinero se mueve de verdad y las transacciones se revisan en PayPhone Business.

Antes de publicar, haz al menos estas pruebas:

• Una compra completa, desde el carrito hasta la página de «pedido recibido», revisando que el pedido pase a Procesando en WooCommerce.
• Una compra desde el celular, que es donde se hace la mayoría.
• Una compra con un producto con variaciones (talla, color), para confirmar que el total que llega a PayPhone es el correcto.
• Que el cliente y la tienda reciban los correos de confirmación.

Reversos: la regla que hay que conocer

La documentación de PayPhone permite reversar una transacción solo el mismo día y hasta las 20:00, usando el identificador de la transacción (transactionID o clientTransactionID), desde PayPhone Business. Si un cliente pide la anulación al día siguiente, ya no es un reverso sino una devolución, y se gestiona de otra forma. Ponlo en tus políticas de devolución para que nadie se sorprenda.

Los errores que más tiempo hacen perder

• La URL de respuesta no coincide. Un http en lugar de https, un www de más o una barra final distinta bastan para que la confirmación no llegue. Cópiala tal cual desde el plugin.
• Credenciales de pruebas en producción, o al revés. Si todo se aprueba pero no ves el dinero, revisa en qué entorno creaste la aplicación.
• La caché guarda páginas que no debe. El carrito, la página de pago y «Mi cuenta» nunca deben servirse desde caché. Los plugins de caché serios los excluyen solos, pero una configuración manual puede incluirlos por error.
• El certificado SSL venció o está mal instalado. El navegador avisa al cliente antes de llegar al pago, y la venta se pierde ahí.
• El usuario no tiene el rol Desarrollador. Sin ese rol no se puede crear la aplicación en PayPhone Developer.

Si prefieres que lo hagamos nosotros

Conectar la pasarela y probarla con compras reales es parte de toda tienda online que desarrollamos en Ecuador, con PayPhone o con Datafast, PlaceToPay, PagoPlux, PayPal o Stripe. Si todavía estás decidiendo la plataforma, revisa antes WooCommerce o Shopify para vender en Ecuador: en Shopify, cada venta con PayPhone paga además una comisión a Shopify.

Fuentes

• PayPhone: plugin para WooCommerce, documentación oficial, consultada el 25 de septiembre de 2026.
• PayPhone: botón de pago, comisión y medios de pago, consultado el 25 de septiembre de 2026.