Saltar al contenido principal
Z2Pay es una plataforma de pagos (PSP). Con una única integración puedes aceptar tarjeta de crédito, PIX y boleto, crear suscripciones recurrentes, dividir montos entre beneficiarios (split) y monitorear todo mediante webhooks en tiempo real. Esta documentación fue escrita para que cualquier persona que nunca haya utilizado la API pueda integrarla desde cero — cada parámetro, cada formato y cada escenario de prueba está descrito aquí.

Empieza en 5 minutos

De cero al primer pago aprobado en el sandbox.

Prueba sin miedo

Entorno sandbox con tarjetas que aprueban y que rechazan — con un generador listo para usar.

Autenticación

Cómo obtener y utilizar tu API key.

Webhooks

Recibe notificaciones de cada cambio de estado.

Lo que NO necesitas construir

La parte compleja y regulada corre por nuestra cuenta:

Cumplimiento PCI

Los datos de la tarjeta son tokenizados por Z2Pay — nunca pasan por tu servidor.

PIX, boleto y cuotas

La generación del QR Code, la línea de pago y el cálculo de cuotas son responsabilidad nuestra.

Enrutamiento entre adquirentes

Registras el gateway una vez; nosotros elegimos la mejor ruta y gestionamos el failover.

Página de pago

Usa el Checkout alojado y olvídate de construir una pantalla de pago.

Dos formas de integrar

Checkout alojado (más simple)

Creas un enlace/sesión y el comprador paga en una página servida por Z2Pay. Sin manipular datos de tarjeta. Ideal para comenzar rápido.

API directa (transparente)

Tú controlas la experiencia y envías el pago vía API, usando un token de tarjeta generado por nuestro tokenizador. Mayor control, pero requiere atención al flujo de tokenización.
Todos los valores monetarios son enteros en centavos (R$ 49,90 = 4990) y las fechas siguen ISO 8601 con timezone. Consulta Convenciones.