Autenticación

El proceso de autenticación es simple y único para todos los servicios de Kambia.

👉 Necesitarás tus credenciales.

La API de Kambia cuenta con dos ambientes y una versión pública (v1):

1. Desarrollo

https://sandbox.kambia.app/v1

2. Producción

https://api.kambia.app/v1

Para validar la autenticidad e integridad de las peticiones, envía estos 3 headers:

Header	Descripción
`x-merchant-key`	Tu clave pública
`x-merchant-signature`	Firma HMAC-SHA256 de la petición
`x-merchant-timestamp`	Marca de tiempo (en milisegundos) de la petición

Construir el elemento a firmar

Es la unión/concatenación (en orden) de los siguientes valores:

Campo	Descripción
`merchant_id`	Tu identificador único en Kambia
`JSON(body)`	Cuerpo de la petición en formato JSON
`timestamp`	Marca de tiempo (en milisegundos) de la petición

El JSON va compacto (sin espacios) y con tildes y ñ tal cual, sin escaparlas, como lo genera JSON.stringify.

Generar la firma HMAC-SHA256

Utiliza tu clave privada merchant-secret para generar un HMAC SHA-256 codificado en hexadecimal:

Te muestro 3 ejemplos de cómo generar los headers de autenticación:

JavaScript

Python

PHP

🤔 ¿Te quedan dudas?
Envíame un mensaje a josue@kambia.app, con todo gusto te ayudaré a resolverlas.