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:
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). |
Ejemplo de Encabezado
{
"Content-Type": "application/json",
"Client-Request-Id": "CLIENT_REQUEST_ID",
"Api-Key": "API_KEY",
"Timestamp": "TIMESTAMP",
}
Updated 4 months ago