1. Introducción
API Kambia
  • Introducción
    • API Kambia
    • Credenciales
    • Autenticación
    • Verificación
      POST
  • Servicios
    • Catálogo de códigos
    • Contrato digital
      • Notificaciones
      • Plantilla digital
      • Create signature
    • Payin
      • Notificaciones
      • Create payin
    • Payout
      • Notificaciones
      • Create payout
    • Débito automático
      • Affiliation
      • Charge
  1. Introducción

Autenticación

El proceso de autenticación es simple y único para todos los servicios de Kambia.
👉 Necesitarás tus credenciales.

Base URL + versión#

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

Headers#

Para validar la autenticidad e integridad de las peticiones, envía estos 3 headers:
HeaderDescripción
x-merchant-keyTu clave pública
x-merchant-signatureFirma HMAC-SHA256 de la petición
x-merchant-timestampMarca de tiempo (en milisegundos) de la petición

¿Cómo firmar la petición?#

1
Construir el elemento a firmar
Es la unión/concatenación (en orden) de los siguientes valores:
CampoDescripción
merchant_idTu identificador único en Kambia
JSON(body)Cuerpo de la petición en formato JSON
timestampMarca de tiempo (en milisegundos) de la petición
2
Generar la firma HMAC-SHA256
Utiliza tu clave privada merchant-secret para generar un HMAC SHA-256 codificado en hexadecimal:

Ejemplos#

Te muestro 2 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.
Modificado en 2026-08-29 23:55:28
Anterior
Credenciales
Siguiente
Verificación
Built with