Cómo configurar Pagopar en Shoperly (paso a paso) | Cobros online

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.

¿Qué vas a necesitar?

Una cuenta en pagopar.com, tu tienda Shoperly en plan Pro y la moneda configurada en guaraníes (PYG). Más abajo explicamos cada requisito.

Requisitos previos

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

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.
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.
Cuenta activa en Pagopar. Necesitás una cuenta de comercio en pagopar.com para obtener tus claves.

El cobro online vuelve obligatorios algunos datos del cliente

Al activar Pagopar, los campos nombre, email, teléfono y CI/RUC del cliente se marcan como obligatorios automáticamente en el checkout. Esto es necesario para procesar el pago.

Habilitá "productos/servicios virtuales" en Pagopar

Paso imprescindible — sin esto ningún pago funciona

Antes de hacer cualquier prueba, pedile al soporte de Pagopar que habilite productos y servicios virtuales en tu cuenta de comercio. Shoperly envía las ventas con esa categoría, así que si tu cuenta no la tiene habilitada, ninguna transacción de prueba va a funcionar (vas a recibir un error al iniciar el pago).

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".

Pantalla "Integrar con mi sitio web" en Pagopar con los tokens y las URLs — Pagopar → Desarrollador → Integrar con mi sitio web

En esta pantalla vas a ver:

Un selector arriba a la izquierda para elegir tu comercio (si tenés más de uno).
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).
Los campos TOKEN PÚBLICO y TOKEN PRIVADO — copialos, los vas a pegar en Shoperly en el siguiente paso.
Más abajo, los campos para configurar las URLs de webhook y redirección (los vas a usar en el paso 5).

Nota

Al principio vas a usar los tokens de Desarrollo. Más adelante, una vez activada Producción, los reemplazás por los de Producción en Shoperly (paso 9).

Cargá las claves en Shoperly

Ya en tu panel de Shoperly:

Andá a Administración → Configuración → Checkout.
En la sección "Pago online", activá el interruptor.
Hacé clic en "Configurar claves".
Pegá tu clave pública y tu clave privada en los campos correspondientes.
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".
Hacé clic en "Guardar".

Modal para configurar las claves de Pagopar en Shoperly — Modal 'Configurar PagoPar' con clave pública y privada

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

Tip

El botón "Verificar credenciales" consulta a Pagopar en el momento. Usalo siempre antes de guardar para asegurarte de que copiaste bien las claves.

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:

Campo en Pagopar	URL a pegar
URL de respuesta (webhook)	`https://shoperly.app/api/webhook/pagopar`
URL de redireccionamiento	`https://shoperly.app/api/pagopar/redirect/($hash)`

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

Importante

Copiá la URL de redireccionamiento tal cual, incluido el ($hash) final: Pagopar lo reemplaza automáticamente por el identificador de cada pago.

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:

El sitio web del comercio inserta el pedido en Pagopar.
En el momento del pago, Pagopar envía la notificación a tu URL de respuesta y tu sitio responde con un JSON.
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.

Tip

Si después de pagar la prueba seguís viendo pasos sin tildar, esperá unos segundos y recargá la página de Pagopar. También podés usar "Simular pago del último pedido" para volver a disparar los webhooks sin pagar de nuevo.

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.

Sección 'Entorno: Producción' con los tres pasos completos y el campo IP's habilitadas — Pagopar → Pasar a entorno Producción

Para activarla:

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

¿Por qué 0.0.0.0?

Shoperly hace los pedidos a Pagopar desde distintos servidores, así que las IPs cambian. Usar 0.0.0.0 le indica a Pagopar que acepte peticiones desde cualquier IP — la seguridad la sostienen igual tus tokens privados y la firma de cada transacció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:

En Pagopar, hacé clic en la pestaña PRODUCCIÓN y copiá los nuevos TOKEN PÚBLICO y TOKEN PRIVADO.
Volvé a Shoperly → Administración → Configuración → Checkout → "Editar claves".
Reemplazá la clave pública y la privada por las de Producción.
Hacé clic en "Verificar credenciales" — el badge debe quedar en verde.
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.

Tip

¿Seguís con dudas? Escribinos por WhatsApp y te ayudamos a dejar tu cobro online funcionando.

Cómo configurar Pagopar en tu tienda Shoperly

¿Listo para crear tu tienda online?