Cómo configurar Pagopar en tu tienda Shoperly

Con Pagopar activado, tus clientes pueden pagar online (tarjetas, billeteras y transferencias) directamente desde tu tienda Shoperly, en lugar de coordinar el pago por WhatsApp. En esta guía te mostramos cómo conectarlo paso a paso.

Requisitos previos

Antes de empezar, verificá que tu tienda cumpla con lo siguiente:

1. Plan Pro. El cobro online con Pagopar está disponible solo en el plan Pro. Si estás en otro plan, vas a ver el mensaje "PagoPar solo está disponible en el plan Pro" en la configuración de checkout.
2. Moneda en guaraníes (PYG). Pagopar solo procesa pagos en guaraníes. Si la moneda de tu tienda no es PYG, cambiala desde la configuración antes de continuar.
3. Cuenta activa en Pagopar. Necesitás una cuenta de comercio en pagopar.com para obtener tus claves.

Habilitá "productos/servicios virtuales" en Pagopar

Escribiles al soporte de Pagopar (por su web o por WhatsApp) y pediles textualmente: "Necesito habilitar productos/servicios virtuales en mi cuenta de comercio". Una vez que te confirmen, podés continuar.

Obtené tus claves de Pagopar

Pagopar te entrega dos claves que identifican a tu comercio: una pública y una privada (en su panel aparecen como "TOKEN PÚBLICO" y "TOKEN PRIVADO" — es lo mismo).

Para encontrarlas, ingresá a pagopar.com y, en el menú lateral, hacé clic en "Desarrollador" y luego en "Integrar con mi sitio web".

En esta pantalla vas a ver:

1. Un selector arriba a la izquierda para elegir tu comercio (si tenés más de uno).
2. La pestaña DESARROLLO activa — es la única que aparece al principio. La pestaña PRODUCCIÓN se desbloquea más tarde, cuando completes una transacción de prueba (lo hacemos en los pasos 7 y 8).
3. Los campos TOKEN PÚBLICO y TOKEN PRIVADO — copialos, los vas a pegar en Shoperly en el siguiente paso.
4. Más abajo, los campos para configurar las URLs de webhook y redirección (los vas a usar en el paso 5).

Cargá las claves en Shoperly

Ya en tu panel de Shoperly:

1. Andá a Administración → Configuración → Checkout.
2. En la sección "Pago online", activá el interruptor.
3. Hacé clic en "Configurar claves".
4. Pegá tu clave pública y tu clave privada en los campos correspondientes.
5. Hacé clic en "Verificar credenciales". Si las claves son correctas, vas a ver un badge verde que dice "Verificadas"; si hay un error, uno rojo que dice "Inválidas".
6. Hacé clic en "Guardar".

Cuando guardes, el estado en la sección de pagos va a pasar a "Claves ingresadas".

Configurá las URLs en el panel de Pagopar

Para que Pagopar le avise a tu tienda cuándo se acreditó un pago y a dónde volver al cliente, tenés que cargar dos URLs en la misma pantalla del paso anterior (Desarrollador → Integrar con mi sitio web, justo debajo de los tokens). Las dos aparecen en el modal de Shoperly con un botón para copiarlas:

Pegá cada URL en su campo y hacé clic en "Actualizar URLs" para guardar.

Elegí el modo de checkout

Por último, definí cómo querés que tus clientes paguen:

• Híbrido: el cliente elige entre pagar online con Pagopar o enviar su pedido por WhatsApp.
• Solo cobro online: todos los pedidos se procesan con pago online a través de Pagopar.

Elegí la opción que mejor se adapte a tu negocio. Podés cambiarla cuando quieras desde la misma pantalla de checkout.

Probá un pedido (completá el circuito de Desarrollo)

Hacé una compra de prueba en tu tienda para confirmar que todo el flujo funciona de punta a punta: agregá un producto al carrito, completá el checkout y pagá ese pedido a través de Pagopar usando el entorno de Desarrollo.

Pagopar va a ir registrando tres chequeos a medida que el pedido avanza:

1. El sitio web del comercio inserta el pedido en Pagopar.
2. En el momento del pago, Pagopar envía la notificación a tu URL de respuesta y tu sitio responde con un JSON.
3. El sitio web del comercio consulta el estado del pedido.

Cuando los tres queden marcados con un check verde, podés pasar a Producción.

Pasá a entorno Producción

Una vez completado el circuito de Desarrollo, en la misma pantalla Desarrollador → Integrar con mi sitio web aparece la sección Entorno: Producción con los tres pasos tildados y un campo nuevo para habilitar IPs.

Para activarla:

1. En el campo IP'S HABILITADAS, ingresá 0.0.0.0.
2. Hacé clic en "Pasar a entorno Producción".

Una vez aprobado, en la parte superior va a aparecer la pestaña PRODUCCIÓN con un par de tokens nuevos.

Actualizá los tokens en Shoperly con los de Producción

Los tokens de Desarrollo no cobran plata real — son solo para probar. Para empezar a recibir pagos de verdad tenés que reemplazarlos por los de Producción:

1. En Pagopar, hacé clic en la pestaña PRODUCCIÓN y copiá los nuevos TOKEN PÚBLICO y TOKEN PRIVADO.
2. Volvé a Shoperly → Administración → Configuración → Checkout → "Editar claves".
3. Reemplazá la clave pública y la privada por las de Producción.
4. Hacé clic en "Verificar credenciales" — el badge debe quedar en verde.
5. Hacé clic en "Guardar".

Listo: tu tienda ya está cobrando online con Pagopar en modo Producción.

Problemas comunes

"PagoPar solo está disponible en el plan Pro". Tu tienda no está en plan Pro. Actualizá tu plan desde Precios.

"PagoPar solo procesa pagos en guaraníes". La moneda de tu tienda no es PYG. Cambiala a guaraníes en la configuración de tu tienda.

El pago falla al iniciar la transacción. Casi siempre es porque no están habilitados los productos/servicios virtuales en tu cuenta de Pagopar. Contactá al soporte de Pagopar para habilitarlos (ver el paso correspondiente más arriba).

El badge muestra "Inválidas" al verificar. Revisá que hayas copiado las claves completas, sin espacios al inicio o al final, y que correspondan a la clave pública y privada correctas.