Skip to main content

​
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.

​
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ó.
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.

​
Formato de las claves

​
Uso en peticiones

Incluye la clave en el header Authorization con esquema Bearer:

​
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.