Entornos

Sandbox y producción comparten endpoints, contratos y modelo de datos. Empiezas en sandbox sin coste y migras a producción cuando estás listo, el mismo código funciona en ambos.

Comparativa rápida

	Sandbox	Producción
Coste	Gratis	Según tarifa acordada
Transacciones PSD2	Contra bancos reales, máx. 1 € por pago	Sin límite de importe
Capacidad	Reducida (entorno de pruebas)	Alta disponibilidad
Funcionalidad	Idéntica en ambos entornos	Idéntica en ambos entornos
Portabilidad	Mismos endpoints, contratos y modelo	Mismos endpoints, contratos y modelo

Importes en sandbox

Las llamadas PSD2 se ejecutan contra los entornos productivos de las entidades bancarias, por lo que las iniciaciones de pago en sandbox están limitadas a 1 € para minimizar el impacto durante tus pruebas.

Sandbox

Para desarrollo e integración, sin coste.

Funcionalidad completa, mismos endpoints

El sandbox replica fielmente el entorno productivo: ofrece la misma funcionalidad y utiliza los mismos endpoints, lo que permite que el código desarrollado sea directamente portable sin necesidad de modificaciones.

Transacciones PSD2

Las llamadas PSD2 se ejecutan contra los entornos productivos de las entidades bancarias. En el caso de las iniciaciones de pago, el importe máximo permitido es de 1 €, con el objetivo de minimizar el impacto durante las pruebas.

Capacidad e infraestructura

El entorno sandbox dispone de recursos de infraestructura inferiores a los de producción. Si durante las pruebas se detectan limitaciones de rendimiento o disponibilidad, ten en cuenta que el entorno productivo cuenta con mayor capacidad.

Endpoints

Servicio	URL
Base URL	https://api-sandbox.zertiban.com
Token	https://api-sandbox.zertiban.com/idp/oauth2/token
Flows	https://api-sandbox.zertiban.com/flow/v1/flows/pagafactu

Acceder al dashboard de sandbox →

Producción

Para tráfico real, con alta disponibilidad y rendimiento.

Alta disponibilidad y rendimiento

Este entorno está dimensionado para garantizar altos niveles de disponibilidad y rendimiento, con mayor capacidad de cómputo y sistemas de redundancia.

Costes según tarifas acordadas

Las operaciones en producción se facturan según las tarifas acordadas en tu contrato.

Endpoints

Servicio	URL
Base URL	https://api.zertiban.com
Token	https://api.zertiban.com/idp/oauth2/token
Flows	https://api.zertiban.com/flow/v1/flows/pagafactu

Acceder al dashboard de producción →

Mismo path, distinto host

Solo cambia el host. El resto del path es idéntico: si tu integración ataca /flow/v1/flows en sandbox, atacará el mismo path en producción.

Migración a producción

Cuando la integración esté finalizada y validada en sandbox, sigue estos pasos:

1. Valida la integración en sandbox. Asegúrate de que tus flujos cubren todos los estados de operación (COMPLETED, REJECTED, EXPIRED, CANCELLED) y de que verificas la firma HMAC de los webhooks.
2. Solicita credenciales de producción. Contacta con [email protected] y te coordinaremos la migración: alta del IBAN beneficiario, generación de clientId/clientSecret y registro de tu endpoint de webhooks.
3. Cambia las variables de entorno. Sustituye ZERTIBAN_BASE_URL, ZERTIBAN_CLIENT_ID, ZERTIBAN_CLIENT_SECRET y ZERTIBAN_WEBHOOK_SECRET por los valores de producción. Despliega.
4. Go-live. Coordinamos contigo la fecha y te acompañamos durante el lanzamiento.

¿Listo para subir a producción?

Cuando la integración esté finalizada y validada en sandbox, contacta con [email protected] para coordinar la migración y definir la fecha de go-live.