Shopify
Esta guía detalla los pasos para habilitar PayU en tu sitio web de Shopify.
Shopify es una plataforma de comercio que te permite crear y administrar fácilmente tu tienda en línea con potentes herramientas integradas. Para más información, visita el sitio web oficial de Shopify.
Requisitos previos
- Una cuenta activa de PayU Latam.
- Un plan válido de Shopify. Ten en cuenta que la funcionalidad de Checkout no está disponible en los planes de prueba. Puedes explorar los planes y precios de Shopify aquí.
Gestión de órdenes en Shopify
Ten en cuenta las siguientes disposiciones al gestionar órdenes en Shopify:
- All orders (Todas las órdenes): Incluye órdenes con los siguientes 2 estados:
- Approved (Aprobadas): Órdenes que están pagadas en su totalidad o parcialmente.
- Pending (Pendientes): Órdenes en espera de completarse cuando el cliente regresa a la tienda después de procesar un pago a través de la pasarela.
- Abandoned checkouts (Procesos de pago abandonados): Aplica a procesos que:
- Quedaron incompletos ya que el usuario no pudo completar el pago o abandonó el sitio de compras.
- Están marcados como Rechazados.
- Permanecen en estado Pendiente sin que el cliente regrese al sitio de compras después del procesamiento del pago a través de la pasarela, esto incluye:
3.1. Pagos en efectivo.
3.2. Pagos con tarjetas de crédito que entren en validación por las reglas de protección antifraude.
Nota
- Shopify NO reserva inventario para ninguno de los escenarios anteriores.
- Para los procesos considerados como abandoned checkout, el sistema solo genera órdenes una vez que la transacción alcanza un estado Aprobado.
Configurar PayU como pasarela de pagos
- Inicia sesión en tu cuenta de Shopify y descarga la app de PayU Latam v2 del app store haciendo clic aquí y seleccionando Instalar.

- Selecciona la tienda donde quieres instalar la aplicación, serás redirigido a la página de instalación, haz clic en Instalar.


- Elige el entorno para la instalación de la aplicación — Pruebas o Producción — según el uso que le vayas a dar:
- Usa el Entorno de Pruebas (Test Environment) si vas a realizar transacciones de prueba con credenciales de sandbox.
- Usa el Entorno de Producción (Production Environment) solo si estás listo para procesar pagos reales con credenciales activas.
Importante
- Asegúrate de no usar credenciales de prueba en el entorno de producción, ni viceversa. Esto puede causar errores o transacciones fallidas.
- Encuentra tus credenciales del entorno de producción iniciando sesión en el Panel de Gestión de PayU, donde podrás encontrar el Merchant ID y el Account ID.
- Encuentra las credenciales del entorno de prueba aquí.
- También puedes revisar o cambiar tus credenciales en la configuración de tu cuenta de Shopify.
- Necesitas un Account ID por cada tienda en Shopify.
Después de seleccionar el entorno correcto, ingresa tu Merchant ID y Account ID, y haz clic en Guardar para confirmar.

- Serás redirigido a la página de Pagos, para habilitar la aplicación, haz clic en el botón Activar ubicado en la esquina inferior derecha.

Importante
- A modo informativo, verás distintos medios de pago. Para avanzar, debes seleccionar por lo menos uno de ellos, esto no modificará los medios de pago que tienes disponible en el Web Checkout de PayU.
- Modo test: Dentro de la misma sección de Pagos, encontrarás la opción para utilizar el modo test que te permitirá hacer pruebas en ambiente Sandbox.
- Recomendamos que utilices el entorno de prueba de manera controlada, preferiblemente durante las horas de menor actividad, ya que las transacciones procesadas en modo de prueba no generan pagos reales y el entorno de producción permanece desactivado.
- Para deshabilitar el modo test, desmarque la caja.

- Ingresa a tu Panel de Gestión de PayU, ve a la sección de Configuración y haz clic en Configuración técnica. Activa la opción llamada Controlar pagos dobles (Validar referencia única) para evitar problemas al momento de procesar tus pagos.

- A partir de ahora, PayU está configurado como tu procesador de pagos, lo que te permite iniciar tus ventas. Con el Web Checkout de PayU, tus clientes pueden realizar compras utilizando diversos métodos de pago, como efectivo, tarjetas de crédito y transferencias bancarias, adaptados al país en el que realizas negocios.
Flujo de pago en Shopify
Cuando configuras PayU como pasarela de pago en la plataforma, tu cliente puede hacer compras de la siguiente forma:
- Tu cliente selecciona el producto o servicio que quiere comprar y luego lo agrega a su carrito de compras.
- En el carrito de compras, tu cliente procede al pago.
- Después de proporcionar su información, tu cliente hace clic en Finalizar el pedido para ser redirigido a PayU Latam para completar el pago.
- Cuando esté en nuestra pasarela de pagos, tu cliente puede ver la descripción de la venta y los métodos de pago disponibles para tu país.
Nota
Recuerda que si requieres realizar un reembolso total o parcial, podrás gestionarlo directamente desde el admin de tu tienda en Shopify. Para más información, haz clic aquí.
Última modificación
19 de mayo de 2025:
Documentation updates (77db4c5f6)