Recaudo Docs

Configuración

Llaves de API

Genera las llaves que usan tus propios sistemas para conectarse con la API de Recaudo.

Antes de empezar

Las llaves están en Configuración › Avanzado › Llaves de API. Necesitas a alguien que programe la integración; si solo quieres recibir avisos de lo que pasa en tu cuenta, revisa también los webhooks.

Tipos de llave

Cada vez que generas llaves obtienes un par, y hay un par para cada entorno:

  • Llave secreta (sk_live_… o sk_test_…): autentica tus llamadas a la API. Úsala solo en tu servidor.
  • Llave pública (pk_live_… o pk_test_…): identifica tu cuenta en el navegador o la app.
  • Producción (live) mueve dinero y datos reales; prueba (test, sandbox) sirve para desarrollar sin cobros reales.

Generar tus llaves

Genera primero las de prueba y, cuando tu integración funcione, las de producción.

  1. Abre Llaves de API

    Entra a Configuración, abre Avanzado y elige Llaves de API.
  2. Elige el entorno

    Ubica la sección Llaves de API de prueba (sandbox) o Llaves de API de producción y haz clic en Generar llaves.
  3. Copia las llaves

    En Llaves de API generadas copia la llave pública y la secreta y guárdalas en un lugar seguro (por ejemplo, las variables de entorno de tu servidor).
  4. Anota tu ID de cuenta

    En la misma página está Tu ID de cuenta, por si tu integración lo necesita.

Usar la llave en tus llamadas

Manda la llave secreta en el encabezado Authorization de cada petición:

Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Los endpoints, errores y paginación están en la referencia de autenticación de la API.

Cambiar o revocar una llave

No hay un botón para rotar: para cambiar una llave, genera una nueva y revoca la anterior.

  1. Genera un par nuevo

    En el mismo entorno haz clic en Generar llaves y copia las nuevas.
  2. Actualiza tu sistema

    Reemplaza la llave en tu servidor y confirma que tus llamadas siguen funcionando.
  3. Revoca la anterior

    En la lista, haz clic en Revocar junto a la llave vieja. Las llamadas que la usen dejarán de funcionar de inmediato.

Tip

Nunca pongas la llave secreta en el código de una página web, una app móvil o un repositorio. Si crees que alguien la vio, revócala en ese momento.

Siguiente paso

¿Te sirvió esta página? Gracias por avisarnos.
Esc