API de Zertiban

API REST unificada para PagaFactu y ZertiPay. Dos entornos (sandbox y producción) y autenticación OAuth2 Client Credentials.

Servidores

Mismos endpoints, contratos y modelo de datos en ambos entornos. Empiezas en sandbox sin coste y migras a producción cuando todo esté validado.

Entorno	Base URL
Sandbox	https://api-sandbox.zertiban.com
Producción	https://api.zertiban.com

Detalle de límites, capacidad y migración en Entornos.

Autenticación

No hay registro self-service ni login interactivo: las credenciales (clientId / clientSecret) se entregan tras el onboarding y todas las llamadas son server-to-server con OAuth2 Client Credentials sobre Basic Auth.

1. Pide un access_token a POST/idp/oauth2/token con grant_type=client_credentials.
2. Inclúyelo como Authorization: Bearer {access_token} en cada llamada posterior.
3. Renueva el token cuando expire.

curl -i -X POST 'https://api-sandbox.zertiban.com/idp/oauth2/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -u '{clientId}:{clientSecret}' \
  --data-urlencode 'grant_type=client_credentials' \
  --data-urlencode 'scope=openid profile api'

Guía completa con ejemplos en Python y axios: Autenticación.

Cómo está organizada

La API se agrupa por servicio (Flow, PagaFactu, Payment, IdP), cada uno con su prefijo en la URL (/flow/..., /pagafactu/..., etc.). El menú izquierdo lista todas las operaciones agrupadas por etiqueta; cada operación tiene su propia página con ejemplos de petición/respuesta, parámetros y códigos de error.

¿Aún no tienes credenciales?

Empieza por Registro y Onboarding.