Estado de una operación

Estimated reading: 3 minutes

La consulta es una funcionalidad que permite asesorarse sobre el estado de las operaciones a través de dos servicios REST diferentes:

Servicio web para el estado completo de una operación. La consulta devolverá todos los intentos del cliente, y en caso de un reembolso asociado, también se incluirá en la respuesta.
Servicio web para consulta de intervalos. La consulta devolverá todas las operaciones para el intervalo de tiempo solicitado. La solicitud se realizará a través de un servicio REST

Operación de consulta

La función de consulta de operaciones permite conocer el estado detallado de una operación. El servicio estará disponible a través de un servicio web publicado bajo las siguientes urls:


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

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 que se hizo	Alfanumérico	Sí
operation	Identificador de la operación del pago para ser informado	Numérico(25)	Sí
signature	Identificador de la operación del pago para ser informado	Caracter	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:

-merchant_identifier, merchant_operation, 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 de la solicitud fueran correctos, este campo no se muestra
payment_code	El código para el pago a capturar. Esta información solo será notificado, si no hubo ningún error en la solicitud de datos, es decir, si no se ha devuelto ningún código de error.	Caracter	No. Sólo se informará si los datos de la solicitud son correctos y por lo tanto se ejecuta el reembolso
amount	Se mostrará el importe cobrado.	Numérico	Sí
operation	Identificador de pago realizado dentro de la pasarela en el iframe. Un merchant_operation puede tener cero o más socios payment_code	Alfanumérico. (Máx 25)	No
bank_operation	Código de operación bancaria. Es el código asignado al pago por la entidad que lo procesa	Caracter(20)	No
channel	Canal a través del cual se informó que el pago ha sido realizado	Caracter	Sí
payment_date	Fecha en la cual el pago se ha realizado	yyyy-MM-ddHH:mm:ss	Sí
authorisation_code	Código asociado solo a pagos con resultado OK. El código no es único	Numérico (6)	No
pan	El número de la tarjeta enmascarada utilizada para el pago a través del canal CARD	Caracter (16)	No. Formato pan 123456xxxxxxx1234
metadata	Los campos libres enviados por el cliente en la integración	Caracter (160)	No
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox	Caracter	Sí

-merchant_identifier, amount, operation, 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 ERROR_CODE

error_code	Descripción
211	Error en el identificador de la operación
251	La operación solicitada no pertenece al comercio
801	Error en la firma
901,911,912	Error del comerciante
999	Error inesperado

Document KX PaymentSuite

Documentación técnica de integración

Estado de una operación

Operación de consulta

Parámetro de solicitud

Parámetros de respuesta

Códigos de error asociados al campo ERROR_CODE