Crea una llave privada para que tu servidor se autentique contra la API de Conekta. Cada llave privada se crea con una lista de scopes: los recursos a los que tendrá acceso y si podrá solo leerlos o también modificarlos. La llave solo funciona en los endpoints que cubren sus scopes.

❗

scopes es obligatorio

Desde las versiones 2.0.0 a 2.3.0 de la API, toda llave privada creada con POST /api_keys debe incluir scopes con al menos un elemento. Si el campo falta, es null o es [], la API responde 422. Las llaves públicas no llevan scopes.

Parámetros

Catálogo de scopes

Cada scope tiene el formato recurso:acción. Un scope :write incluye el :read del mismo recurso: una llave con orders:write también puede leer órdenes.

📘

Asigna solo lo que tu integración usa

Si una llave se expone, el impacto se limita a sus scopes. Usa una llave distinta por integración en lugar de una sola llave con todos los permisos.

Ejemplo

curl -X POST https://api.conekta.io/api_keys \
  -H "Accept: application/vnd.conekta-v2.3.0+json" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer key_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{
    "role": "private",
    "description": "tienda en línea",
    "scopes": ["orders:write", "charges:read", "webhooks:read"]
  }'

La respuesta incluye los scopes asignados a la llave:

{
  "id": "64625cc9f3e02c00163f5e4d",
  "object": "api_key",
  "role": "private",
  "description": "tienda en línea",
  "active": true,
  "livemode": false,
  "prefix": "key_rp",
  "created_at": 1684167881,
  "deactivated_at": null,
  "last_used_at": null,
  "authentication_token": "key_xxxxxxxxxxxxxxxxxxxxxxxx",
  "scopes": ["charges:read", "orders:write", "webhooks:read"]
}

🚧

Guarda el authentication_token en un lugar seguro

Solo se muestra en la respuesta de creación. Consulta API Keys Producción para gestionar tus llaves.

Errores frecuentes

Consulta el catálogo completo en Códigos de error HTTP.

Relacionado

• API Keys Producción — crear y administrar llaves desde el panel.
• API Keys Pruebas — llaves para el modo de pruebas.
• Rotación de llaves de API — reemplazar una llave sin interrumpir tu integración.