Encabezado de la Solicitud

Colombia

La API de Tarjeta Presente tiene una estructura coherente de encabezados basada en un set de parámetros. Para crear el encabezado, proporcione los siguientes valores:

Ejemplo de Encabezado

{
  "Content-Type": "application/json",
  "Client-Request-Id": "CLIENT_REQUEST_ID",
  "Api-Key": "API_KEY",
  "Timestamp": "TIMESTAMP",
}

Variable Tipo Descripción/Valores
Content-Type string El tipo de contenido. Valor Válido (Aplicación/JSON)
Client-Request-Id string Una identificación generada por el Cliente para el seguimiento de solicitudes y la creación de firmas, única por solicitud. Esto también se utiliza para el control de idempotencia. Se recomienda un Formato UUID de 128 bits.
Message-Authentication-Value string El Valor de Autenticación de Mensaje (MAC) es un encabezado opcional y solo es necesario para transacciones con Tarjeta Presente o transacciones originadas desde terminales. El formato del parámetro del encabezado OpenAPI para el valor de autenticación de mensaje de la carga útil completa sigue el patrón: ;;[;][;].
Api-Key string Llave dada al comercio después de asociar sus solicitudes con la aplicación apropiada en Apigee.
Fecha/Hora Número Entero Marca de tiempo de época en milisegundos en la solicitud de un sistema Cliente. Se utiliza para la generación de firmas de mensajes y el límite de tiempo (5 minutos).
Formato: int64
Valor Mínimo: -9223372036854776000
Valor Máximo: 9223372036854776000
Message-Signature string Se utiliza para garantizar que la solicitud no haya sido manipulada durante la transmisión. El Message-Signature es el hash HMAC codificado por Base64 (algoritmo SHA256 con el API Secret como llave).