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.

Panel de integración

  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

TipoPrefijoModo en /health
Sandboxsk_test_sandbox
Producciónsk_live_live
No uses una clave zp_org_... (SDK) en Connect. El servidor la rechazará. Son productos y credenciales separados.

Uso en peticiones

Incluye la clave en el header Authorization con esquema Bearer:
curl -X GET "https://api.zopay.cash/connect/v1/health" \
  -H "Authorization: Bearer sk_test_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. /connect/v1/health es la excepción: funciona con cualquier clave válida para comprobar autenticación, aunque la cuenta no esté aprobada. Más detalle en Autenticación.