Skip to navigation

Prueba tus credenciales de autenticación

Confirma la cuenta efectiva y el ambiente seleccionado por X-SECRET-KEY (y X-ACCOUNT-ID para cuentas conectadas). Abrir Sandbox en el dashboard no cambia el ambiente de tu código: usa la llave TEST creada dentro del Sandbox.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Response

Respuesta exitosa
messagestring
Mensaje de saludo con el nombre de tu cuenta
account_idstring
ID de la cuenta efectiva, incluida la cuenta conectada si aplica.
environmentenum

sandbox identifica un tenant aislado; live, la cuenta LIVE.

Allowed values:
sandbox_idstring or null

ID del Sandbox del tenant o de su cuenta conectada; null fuera de Sandbox.

Errors

401
Unauthorized Error