Panel de integración
- Accede al panel de integración con tu cuenta de organización.
- En la sección de desarrolladores, genera una clave sandbox (
sk_test_...) para pruebas.
- 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.
Una sola clave para todo
La misma clave Connect autentica todas tus llamadas a la API. El SDK del navegador no usa claves — sólo monta el widget con un paymentIntentId que tu servidor ya creó.
| Componente | Usa una clave |
|---|
| Connect API (servidor) | Sí — sk_test_… o sk_live_… en el header Authorization |
SDK del navegador (@zopay/js) | No — sólo recibe el envelope PaymentIntent desde tu backend |
Nunca expongas una clave sk_live_… ni sk_test_… en código que corre en el navegador. El SDK fue diseñado para que no la necesite — tu backend crea el intent y devuelve sólo el id al cliente.
| Tipo | Prefijo | Modo en /health |
|---|
| Sandbox | sk_test_ | sandbox |
| Producción | sk_live_ | live |
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.
