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_…osk_test_…): autentica tus llamadas a la API. Úsala solo en tu servidor. - Llave pública (
pk_live_…opk_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.
-
Abre Llaves de API
Entra a Configuración, abre Avanzado y elige Llaves de API. -
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. -
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). -
Anota tu ID de cuenta
En la misma página está Tu ID de cuenta, por si tu integración lo necesita.
Cuidado
Las llaves se muestran una sola vez. Después solo verás el inicio y los últimos 4 caracteres. Si pierdes la secreta, genera un par nuevo y revoca el anterior.
Usar la llave en tus llamadas
Manda la llave secreta en el encabezado Authorization de cada petición:
Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
curl https://recaudo.app/api/v1/customers \
-H "Authorization: Bearer sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Accept: application/json"
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.
-
Genera un par nuevo
En el mismo entorno haz clic en Generar llaves y copia las nuevas. -
Actualiza tu sistema
Reemplaza la llave en tu servidor y confirma que tus llamadas siguen funcionando. -
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.