Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zopay.cash/llms.txt

Use this file to discover all available pages before exploring further.

Todas las peticiones a Connect deben incluir tu clave en el header Authorization con esquema Bearer.

​
Obtener tus claves

  1. Accede al panel de integración con tu cuenta de organización.
  2. En la sección de desarrolladores, genera una clave sandbox (sk_test_...) para pruebas.
  3. Cuando tu organización esté aprobada, genera una clave live (sk_live_...) para producción.
Guarda cada clave en un gestor de secretos. Solo se muestra una vez al crearla; no podrás recuperarla después.

​
Formato de las claves

TipoPrefijoUso
Sandboxsk_test_Desarrollo y pruebas
Producciónsk_live_Operaciones reales
No uses una clave zp_org_... (SDK) en Connect. El servidor la rechazará. Son productos y credenciales separados.

​
Ejemplo de petición

curl -X GET "https://api.zopay.cash/connect/v1/balances" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

​
Cuenta aprobada

Los endpoints que implican movimiento de fondos exigen que tu organización esté activa en Connect. Si aún está en pending_verification o suspended, recibirás HTTP 403 con código account_pending_approval.

​
Errores de autenticación

SituaciónHTTPCódigo típico
Sin header o formato incorrecto401authentication_required
Clave inválida o revocada401authentication_required
Clave sk_test_ en flujo que exige live (o al revés)401authentication_required
No compartas claves en repositorios públicos, logs ni capturas de pantalla. Rota la clave desde el panel si sospechas una filtración.