Consulta de intervalo

Lectura estimada: 2 minutos

Funcionalidad que permite consultar a través de un servicio web de las operaciones disponibles realizadas entre dos fechas.

El intervalo consultado no pude ser superior a un mes

La funcionalidad permite conocer el estado detallado de una operación

El servicio estará disponible a través de un servicio REST publicado en las siguientes urls :


Test Enviroment	https://test.imspagofacil.es/client2/rservices/v1/checkOperations
Production Enviroment	https://imspagofacil.es/client2/rservices/v1/checkOperations

Parámetro de solicitud

Parámetros	Descripción	Tipo de dato	Requerido
merchant_identifier	Código de comercio a través del cual se realiza el pago	Alfanumérico	Sí
from_date	Fecha desde la cual se comprueba las operaciones. La operación de la fecha en especifico deberá ser incluida	Fecha YYYMMDDHHMMSS	Sí
to_date	Fecha hasta la cual se comprueba las operaciones. La operación de la fecha en específico deberá ser incluida	Caracter	Sí
status	El estado de las operaciones deberá incluirse. Los posibles valores son: ALL (todas las operaciones), OK (Sólo operaciones OK), TRIES (Sólo operaciones OK y KO, los accesos al marco de pago sin intentos de pago serán excluidos)	Caracter	No, en caso de que este campo no esté definido, el valor ALL será tomado por defecto
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox.	Caracter	Si

El campo «signature» contendrá una firma calculada a partir de los parámetros enviados. El proceso de cálculo del algoritmo y firma se detalla en el Anexo-1 de este documento. El orden de los campos es el siguiente:

-merchant_identifier, from_date, to_date, signature

El campo signature no viaja en la solicitud. Será facilitado por Kíneox y estará asociado con el campo merchant_identifier

Parámetros de respuesta

Parámetros	Descripción	Tipo de dato	Requerido
error_code	Campo que indicará el código de error de los últimos parámetros, si existiese	Caracter (3)	No. Si los datos requeridos son correctos, este campo no se mostrará
operations	Lista de las operaciones asociadas a la fecha del intervalo. Puede ser 0 o más elementos en el tipo «operation»		No, solo se informará si los datos de solicitud fueran correctos, y los datos relacionados con la consulta existente
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox.	Caracteres	Sí

El campo SIGNATURE contendrá una firma calculada a partir de los parámetros enviados. El proceso de cálculo del algoritmo y firma se detalla en el Anexo-1 de este documento. El orden de los campos es el siguiente:

-error_code, merchant_identifier, signature

El campo signature no viaja en la solicitud. Será facilitado por Kíneox y estará asociado con el campo merchant_identifier

Códigos de error asociados al campo ERRORCODE

error_code	Descripción
701	Error en uno de los campos de la fecha
702	El rango de la fecha no es válido
711	El campo «status» contiene un valor inválido
801	Error en la firma
901,911,912	Error del comerciante
999	Error inesperado

Documentación KX PaymentSuite

Documentación técnica de integración

Consulta de intervalo

Parámetro de solicitud

Parámetros de respuesta

Códigos de error asociados al campo ERRORCODE