Devolución

Lectura estimada: 2 minutos

Integración de reembolso

Esta sección detalla una guía para integrar el proceso de reembolso de pagos entre el comerciante y la aplicación POST.

La solicitud se realizará a través de un servicio web tipo REST.

El servicio estará disponible a través de un servicio web publicado bajo los siguientes urls:


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

Solicitud de parámetros

Parámetros	Descripción	Tipo de dato	Requerido
merchant_identifier	Código de comerciante a través del cual el pago fue realizado	Alfanumérico	Sí
amount	Importe a devolver	Numérico. Será multiplicado por 100 para evitar enviar separadores decimales, así que un pago de €145,70 será enviado como 14570	Sí
operation	Identificador de la operación del pago a realizar integrado	Numérico(25)	Sí
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox	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 la carpeta «Cálculo de firma» de esta web.

El orden de los campos es el siguiente:

-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

Parámetros de respuesta

Parámetros	Descripción	Tipo de dato	Requerido
error_code	Este campo indicará el código de error de los último parámetros si existiese	Caracter	No. Si los datos requeridos son correctos, este campo no se muestra
refund_code	El código de estado para el reembolso. Esta información solo será mostrada si no hubo ningún error en la solicitud de datos, es decir, si no se ha devuelto error_code.	Caracteres (3)	No. Sólo se informará si los datos de la solicitud son correctos y por lo tanto, se ejecuta el reembolso
refund_operation	Identificador de la operación proporcionada por la entidad	Caracteres (12)	No. Sólo se informará si los datos de la solicitud son correctos y por lo tanto, se ejecuta el reembolso
authorisation_code	Código de autorización proporcionado por la entidad	Caracteres (6)	No. Sólo se informará si el reembolso ha sido exitoso
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox	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, 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
201-202-251-253	Error en el identificador de la operación
301-302	Error en la cantidad
801	Error en la firma
901-911-912-951-952	Error del comerciante
991;999	Error inesperado

Códigos de retorno asociados con el campo REFUND_CODE

Refund_code	Descripción
000	Operación OK
100	Error en la devolución – KO
500	t/o de conectividad – KO
800	Devolución no completada
900	Code no mapeado – KO
999	Error inesperado – KO

Ejemplo de petición

				
					{
"merchant_identifier":"prb",
"amount":"1400",
"operation":"KX002", 
"signature":"cd22c009d4d0f121f07139d4a3da4e8ce68eb13ca5fe966bb14647297086ef46"
}

Documentación KX PaymentSuite

Documentación técnica de integración