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://nc-api-sandbox.zertiban.com |
| Token | https://nc-api-sandbox.zertiban.com/idp/oauth2/token |
| Flows | https://nc-api-sandbox.zertiban.com/pagafactu/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://nc-board.zertiban.com |
| Token | https://nc-board.zertiban.com/idp/oauth2/token |
| Flows | https://nc-board.zertiban.com/pagafactu/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:
- 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.
- Solicita credenciales de producción. Contacta con [email protected] y te coordinaremos la migración: alta del IBAN beneficiario, generación de
clientId/clientSecrety registro de tu endpoint de webhooks. - Cambia las variables de entorno. Sustituye
ZERTIBAN_BASE_URL,ZERTIBAN_CLIENT_ID,ZERTIBAN_CLIENT_SECRETyZERTIBAN_WEBHOOK_SECRETpor los valores de producción. Despliega. - 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.