Integraciones ecommerce

Preparación

Antes de instalar

Credenciales

Genera primero una clave vp_test_ en Panel → Desarrolladores. La clave live se activa al salir a producción.

Bancos conectados

Configura al menos una pasarela bancaria activa para que el checkout pueda ofrecer un método de pago.

Ambiente de prueba

Completa un pedido en sandbox y confirma el cambio de estado antes de procesar pagos reales.

Regla de seguridad: las claves de producción pertenecen al servidor o al módulo instalado. Nunca las insertes en el JavaScript público del tema de tu tienda.

Plugin para WordPress

Instalar VeriPay en WooCommerce

La extensión añade VeriPay como método de pago, crea el link de cobro para cada orden y sincroniza la confirmación con el estado del pedido en WooCommerce.

1
Obtén el archivo ZIP oficial del plugin VeriPay desde tu canal de incorporación o soporte y conserva el archivo sin descomprimir.
2
En WordPress abre Plugins → Añadir plugin → Subir plugin, selecciona el ZIP, instala y activa la extensión.
3
Ve a WooCommerce → Ajustes → Pagos → VeriPay, activa el método e introduce tu API key de prueba.
4
Configura el título mostrado en checkout, el ambiente Sandbox y los estados que usarán los pedidos aprobados o rechazados.
5
Guarda los cambios. Si el plugin muestra una URL de webhook, cópiala en Panel VeriPay → Desarrolladores → Webhooks.

Validación final

VeriPay aparece entre los métodos de pago del checkout.
La orden queda pendiente mientras el cliente paga.
Un pago aprobado cambia la orden al estado configurado.
La referencia VeriPay queda guardada en las notas del pedido.

App de integración

Instalar VeriPay en Shopify

La app conecta cada pedido con un checkout alojado de VeriPay y devuelve al cliente a la tienda cuando la operación termina.

1
Abre el enlace oficial de instalación de la app VeriPay suministrado para tu comercio e inicia sesión como propietario de la tienda.
2
Revisa los permisos solicitados y confirma Instalar app. VeriPay solo debe acceder a la información necesaria para identificar y actualizar pedidos.
3
Dentro de la app, conecta tu cuenta VeriPay e introduce primero una API key vp_test_.
4
Selecciona Sandbox, define la moneda y revisa la URL de retorno de la tienda que la app detectó automáticamente.
5
Activa VeriPay en Configuración → Pagos cuando la pantalla de instalación lo indique y completa una orden de prueba.

Validación final

La app figura como instalada y conectada.
El método VeriPay está visible para el cliente elegible.
El retorno lleva a la página correcta de la orden.
La confirmación actualiza el pago sin intervención manual.

Aplicación de checkout

Instalar VeriPay en Jumpseller

La integración usa el flujo de pago externo de Jumpseller para enviar al cliente a VeriPay y devolver el resultado a la orden original.

1
Abre la URL de instalación entregada por VeriPay mientras tienes iniciada la sesión de administrador de tu tienda Jumpseller.
2
Autoriza la aplicación y selecciona la tienda donde deseas instalarla.
3
Ingresa la API key de prueba, activa Sandbox y confirma la dirección pública de tu tienda.
4
En el administrador de Jumpseller abre Configuración → Pagos y habilita VeriPay si aún aparece desactivado.
5
Realiza una compra de prueba, completa el checkout de VeriPay y valida el regreso a la página de confirmación de Jumpseller.

Validación final

El método está activo en la configuración de pagos.
Monto y número de orden llegan correctamente a VeriPay.
La tienda recibe la confirmación del pago.
Una operación fallida no marca la orden como pagada.

Módulo conectado

Instalar VeriPay en Proverium

El módulo de Proverium permite asociar cobros y referencias VeriPay con los documentos y operaciones de tu comercio. Los nombres de menú pueden variar según la versión instalada.

1
Solicita o descarga el módulo VeriPay compatible con tu versión de Proverium y crea un respaldo de la configuración antes de instalarlo.
2
Desde Módulos o Integraciones, carga el paquete de VeriPay, ejecuta la instalación y habilítalo para la empresa correspondiente.
3
Abre la configuración del módulo, pega la API key de prueba y selecciona el ambiente Sandbox.
4
Asocia los estados de pago de VeriPay con los estados operativos o documentos que utiliza tu flujo de Proverium.
5
Guarda, procesa una operación de prueba y comprueba que la referencia y el estado queden registrados.

Validación final

El módulo corresponde a la versión activa de Proverium.
La empresa y la pasarela bancaria correctas están seleccionadas.
El resultado se refleja en el documento relacionado.
Los registros no contienen la API key completa.

API VeriPay

API REST universal

Instalar VeriPay en cualquier sitio

Si tu plataforma es propia o no aparece en la lista, usa la API para crear un link de pago por pedido, redirigir al cliente y confirmar el resultado desde tu servidor.

1
Genera una API key de prueba en Panel → Desarrolladores y guárdala como secreto del servidor.
2
Desde tu backend crea un link con POST /api/v1/payment-links incluyendo monto, concepto y una returnUrl HTTPS.
3
Redirige el navegador del cliente a la propiedad url devuelta por VeriPay.
4
Recibe el regreso del cliente y el webhook, pero confirma siempre el pago consultando el recurso por su id antes de entregar el pedido.
5
Cuando todas las pruebas pasen, sustituye la clave vp_test_ por vp_live_ y repite una operación real de importe controlado.

crear-link-de-pago.js

const response = await fetch("https://itsverypay.com/api/v1/payment-links", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": process.env.VERIPAY_API_KEY,
  },
  body: JSON.stringify({
    monto: 1250.50,
    concepto: "Orden #4412",
    returnUrl: "https://mitienda.com/checkout/retorno",
    expiraEn: 3600,
  }),
});

const paymentLink = await response.json();
// Redirige al cliente a paymentLink.url

Ver referencia completa de la API

Validación final

La API key solo se usa en el backend.
Cada orden conserva el id de pago de VeriPay.
El webhook valida firma y tolera reintentos.
La entrega depende de verificado === true.

De sandbox a producción

Antes de activar una clave live, revisa con tu equipo la URL de retorno, el webhook, la relación entre pedido y pago, el manejo de reintentos y la respuesta ante una operación rechazada.

Ir al panel VeriPay Revisar el sandbox