Skip to main content

¿Qué es PixelPay?

PixelPay es el procesador de pagos en línea más usado en Honduras y El Salvador. Permite a los negocios aceptar pagos con tarjeta de crédito y débito (Visa, Mastercard, Amex) a través de un enlace seguro, sin necesidad de una terminal física ni de una tienda en línea compleja. HIVRA se integra directamente con PixelPay para que puedas generar y enviar enlaces de cobro desde WhatsApp, con confirmación automática cuando el cliente paga.

Requisitos previos

Para conectar PixelPay con HIVRA necesitas:
  • Una cuenta de comercio activa en PixelPay (pixelpay.app)
  • Que tu cuenta haya pasado el proceso de verificación de PixelPay
  • Tus credenciales de API (Key ID y Secret Key)
El proceso de aprobación de PixelPay para nuevos comercios toma entre 24 y 72 horas hábiles. Inicia el proceso con anticipación si quieres activar los cobros desde el primer día de uso de HIVRA.

Conectar PixelPay

1

Obtener tus credenciales de API

En tu panel de PixelPay, ve a Configuración → API Keys. Copia tu Key ID y tu Secret Key. Guárdalos en un lugar seguro — el Secret Key solo se muestra una vez.
2

Abrir la configuración en HIVRA

En HIVRA, ve a Integraciones → PixelPay y haz clic en Conectar.
3

Ingresar las credenciales

Pega tu Key ID y Secret Key en los campos correspondientes. Selecciona el ambiente: Producción (para cobros reales) o Sandbox (para pruebas).
4

Configurar la moneda

Selecciona si tus cobros serán en Lempiras (HNL) o Dólares americanos (USD). Esta configuración afecta todos los enlaces generados desde HIVRA.
5

Guardar y verificar

Haz clic en Guardar y verificar conexión. HIVRA realizará una llamada de prueba a la API de PixelPay para confirmar que las credenciales son correctas. Si hay algún error, verás un mensaje descriptivo indicando qué revisar.

Ambiente Sandbox (pruebas)

Antes de activar PixelPay en producción, te recomendamos probar el flujo completo en el ambiente Sandbox:
1

Activar modo Sandbox

En la configuración de PixelPay en HIVRA, selecciona Sandbox como ambiente.
2

Generar un cobro de prueba

Desde el inbox, genera un enlace de cobro por cualquier monto.
3

Pagar con tarjeta de prueba

PixelPay proporciona números de tarjeta de prueba:
  • Número: 4111 1111 1111 1111
  • Fecha: cualquier fecha futura
  • CVV: cualquier 3 dígitos
4

Verificar la confirmación

Si la integración está correctamente configurada, recibirás la notificación de pago confirmado en el inbox de HIVRA.

Webhooks de confirmación

HIVRA escucha los webhooks de PixelPay para confirmar pagos en tiempo real. La URL del webhook se configura automáticamente al conectar — no necesitas hacerlo manualmente. Si experimentas problemas con confirmaciones de pago que no llegan, verifica en tu panel de PixelPay que el webhook esté activo en Configuración → Webhooks.

Límites y comisiones

Las comisiones y límites de transacción los establece PixelPay directamente con tu cuenta de comercio y pueden variar según tu tipo de negocio y historial transaccional. HIVRA no cobra comisión adicional sobre los pagos procesados — solo cobra su suscripción mensual independientemente del volumen. Para consultar tus condiciones específicas, contacta directamente a PixelPay.

Reembolsos

Los reembolsos se procesan directamente desde el panel de PixelPay, no desde HIVRA. Cuando necesites hacer un reembolso:
  1. Accede a tu panel en pixelpay.app.
  2. Busca la transacción por número de orden o monto.
  3. Solicita el reembolso desde la interfaz de PixelPay.
HIVRA actualiza automáticamente el estado del cobro cuando PixelPay procesa un reembolso. El cliente no recibirá ninguna notificación automática de HIVRA sobre el reembolso — deberás comunicarlo manualmente por WhatsApp.
Nunca compartas tu Secret Key de PixelPay con nadie, incluyendo el equipo de soporte de HIVRA. Si sospechas que tu Secret Key fue comprometida, regénérala inmediatamente en tu panel de PixelPay y actualiza las credenciales en HIVRA.
Si manejas cobros en múltiples monedas (por ejemplo, lempiras para clientes locales y dólares para turistas), puedes configurar dos cuentas de PixelPay — una por moneda — y seleccionar la correspondiente al generar cada enlace.