Pago recurrente

Lectura estimada: 3 minutos

Esta sección proporciona una descripción detallada de la integración de pagos recurrentes a través de POS

Los pasos involucrados en el proceso de pago serán los siguientes:

Pago recurrente inicial

Habrá un pago inicial a través de la interfaz web, igual que en las anteriores integraciones pero con ligeras modificaciones que se detallarán en este apartado

Pago recurrente sucesivo

Los pagos sucesivos se solicitarán a través de un servicio web específico del TPV

Pago recurrente Inicial

La diferencia se detalla a continuación, solo diferenciado de un pago no recurrente como se indica en el punto siguiente.

Nuevo campo en la composición de la solicitud del objeto

Habrá un nuevo campo en PARAMS

PARAMS (Mapa donde la clave y el valor son cadenas)

- PAYMENT_TYPE

Nuevo parámetro en la solicitud del objeto

Parámetro	Descripción	Tipo de dato	Requerido
payment_type	Tipo de pago que se va a realizar. 2 posibles valores : -RI: Pago recurrente inicial -PN: Pago no recurrente (predeterminado)	Caracter (2)	Sí

Los otros campos serán exactamente igual que como se encuentran definidos en la tabla de la estructura de la solicitud del objeto

Pago recurrente sucesivos

El comercio accede a los pagos recurrentes a través de un servicio web bajo las siguientes urls:


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

Parámetros requeridos

Parámetro	Descripción	Tipo de dato	Requerido
merchant_identifier	Código único de comerciante proporcionado por Kíneox	Alfanumérico	Sí
amount	Cantidad a pagar	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 de pago que se está realizando	Numérico(25)	Sí
payment_operation	Identificador de la operación del pago inicial	Numérico(25)	Sí
payment_type	Tipo de pago a ejecutar. Por defecto RS, otro valor AU (Autorización, es necesario capturar después del pago recurrente inicial)	Caracter (2)	No
description	Descripción del pago. Va a aparecer como concepto del pago en el TPV	Caracteres (max.200). Sólo caracteres del alfabeto español o los siguientes: Vacío, guion, guion bajo, punto y coma.	No
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:

-merchant_identifier, amount, merchant_operation, payment_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ámetro	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 muestra
payment_code	El estado del código para el pago. Esta información solo será anunciada si no existe error en los datos de la solicitud, es decir, si no se ha devuelto ningún error_code	Caracter (3)	No, solo se informará si los datos de la solicitud son correctos y por lo tanto el pago es ejecutado
payment_operation	Identificador de operación proporcionado por la entidad	Caracteres (12)	No, solo se informará si los datos de la solicitud son correctos y por lo tanto el pago es ejecutado
authorisation_code	Código de autorización proporcionado por la entidad	Caracteres (6)	No, solo se informa si el pago ha sido exitoso
bank_code	Código de error original del banco	Caracteres (6)	No, solo se informa si el pago ha sido rechazado
pan	Se devolverá el número de tarjeta, enmascarado por seguridad.	Caracteres (16)	No, sólo se mostrara cuando la operación ha sido exitosa
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox.	Caracter	Sí

-error_code, authorisation_code, payment_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
101-103	Error de concepto
201-206	Error en identificación de operación
251	La operación solicitada no pertenece al comercio
252	El pago inicial no es un OK
253	Error en la operación inicial, no recurrente
301-303	Error en la cantidad
801	Error en la firma
901-951	Error del comerciante
999	Error inesperado

Códigos de retorno asociados al campo PAYMENT CODE

Los posibles códigos en el campo PAYMENT CODE serán exactamente los mismos que se serán definidos a continuación.

Valores de PAYMENT_CODE

Posibles estados de la respuesta de pago

00	Descripción
000	Pago Ok
010	Autorización Ok
100	Pago KO, Denegado por el emisor
210	Captura denegada, autorización finalizada
211	Problemas con la validación 3D
212	Denegada por el límite de cantidad máxima permitido, revisar normas anti fraude
213	Denegada por duplicidad, misma tarjeta, misma cantidad y operación anterior, siendo denegada por el emisor
214	Problemas con DCC ( Conversión Dinámica de Moneda)
300	Pago pendiente
500	Pago KO, tiempo de conexión agotado
501	Devolución automática por problemas con la operación inicial
505	Procesamiento 3D Secure
506	La tarjeta no soporta 3D Secure
507	Soft Decline
701	Pago KO por seguridad, solo admite pagos seguros
702	Pago KO por seguridad, pago denegado por entidad no segura
704	Pago KO por seguridad, número máximo de tarjetas
720	Pago KO por seguridad, cantidad máxima en las restricciones auxiliares
721	Pago KO por seguridad, cantidad máxima por IP
722	Pago KO por seguridad, límite máximo de importe con tarjeta
723	Pago KO por seguridad, límite máximo de monto por operación con tarjeta
724	Pago KO por seguridad, límite máximo de monto aceptado en las restricciones auxiliares
725	Pago KO por seguridad, máximo total de operaciones por IP
726	Pago KO por seguridad, monto máximo por IP
727	Pago KO por seguridad, número máximo de operaciones por IP
728	Pago KO por seguridad, cantidad máxima por IP en las restricciones auxiliares
729	Pago KO por seguridad, número máximo de operaciones por IP en las restricciones auxiliares
730	Pago denegado por cuota finalizada
731	La tarjeta ha sido denegada
732	Tarjeta en riesgo de fraude
749	Pago KO por seguridad, intento de pago duplicado en la misma operación
785	Pago denegado porque no se acepta tarjeta de crédito (Revisar la configuración)
786	Pago denegado porque no acepta tarjeta comercial (Revisar la configuración)
787	Pago denegado porque no acepta el país emisor de la tarjeta (Revisar la configuración)
788	Pago denegado porque la tarjeta aparece en la lista negra
789	Pago denegado por seguridad. Estrategia negra
794	Pago KO por seguridad, pago denegado por intento de pago con tarjeta denegada
795	Pago KO por seguridad, pago denegado por no encontrar coincidencia entre el país de emisión y la IP
796	Pago KO por seguridad, pago denegado ya que el país de residencia no coincide con la IP
797	Pago KO por seguridad, denegado debido al filtro BIN de la tarjeta
798	Pago KO por seguridad, denegado debido a los filtros de seguridad para tarjetas
799	Pago KO por seguridad, pago denegado debido a los filtros de IP
800	Pago no finalizado
950	Error de integración en la invocación del servicio
900	Pago KO. Código original no reconocido
999	Pago KO. Error inesperado

Ejemplo de petición

				
					{
"merchant_identifier":"prb",
"amount":"10",
"merchant_operation":"111",
"payment_operation":"320040911420",
"payment_type":"RS",
"description":"Concepto de prueba",
"signature":"6321608fe25dca466491ae7b995715c13a67338a7b9216faa73ca2b083c184aa"
}

Ejemplo de respuesta

				
					{
    "error_code": "000",
    "payment_code": "000",
    "payment_operation": "469694598121",
    "authorisation_code": "514836",
    "signature": "9c4f71b9800752b4ac9de9ac90b935fcf15388d4f0b7084c14811c99d7581011",
    "bank_code": "0000",
    "entity_reference": null,
    "pan": "123412xxxxxx9046"
}

Documentación KX PaymentSuite

Documentación técnica de integración