Pay by reference

Estimated reading: 3 minutes

PAGO 1-CLICK

El pago con un click ofrece a los comerciantes enormes posibilidades para realizar pagos en su tienda en línea. Si un negocio tiene muchos clientes recurrentes y quiere ofrecer pagos futuros más fáciles y rápidos a aquellos clientes que ya conocen y operan al menos una vez, existe una opción de pago en un clic que puede ser por Tokenización, de esta manera el titular no tiene que volver a incluir los datos de su tarjeta en futuras compras

Tras crearse la referencia en un pago anterior, para hacer un segundo pago, no es necesario volver añadir los datos de tarjeta, en su lugar se añade el parámetro merchant_identifier con el valor de la referencia a utilizar.


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

Parámetros de la solicitud

Parámetros	Description	Tipo de dato	Requerido
merchant_identifier	Código que identifica al comercio en la pasarela de pagos.	Alfanumérico	Si
amount	Cantidad que será cobrada	Numérico. Será multiplicado por 100 para evitar enviar separadores decimales, así que un pago de €145,70 será enviado como 14570	Si
operation	Código que identificará esta nueva operación en concreto	Numérico (máx 25)	Si
payment_operation	Identificador del primer pago realizado	Numérico (máx 25)	Si
payment_type	Tipo de pago que se realizará. Por defecto será RS, otro valor que admite sería AU (Autorización, es necesario capturar después del pago OK)	Caracter (2)	No
description	Descripción del pago	Caracter (máx 200) Sólo caracteres del alfabeto español, o los siguientes caracteres: en blanco, guión, guión bajo, punto y coma	No
currency	Identificador numérico internacional de la moneda en la que se realiza el pago (Es decir, para el euro será 978) según el estándar ISO-4217	Numérico (máx 3)	No, si no se envía, será el euro por defecto.
signature	Firma de los parámetros enviados con contraseña de firma, esta es proporcionda por Kíneox	Alfanumérico	Si

El campo «signature» contiene una firma calculada para los parámetros enviados.

El algoritmo y proceso de cálculo de la firma será detallada en el Annexo-1 de este documento. El orden de los campos que forman la firma es el siguiente:

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

Respuesta del servicio

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
payment_code	El estado del código para la captura del pago. Esta información solo será informada si no hubo error en los datos de la solicitud, es decir, si no se ha devuelto ningún código de error.	Caracter (3)	No, solo se informará si los datos de la solicitud son correctos y por lo tanto se ejecuta el reembolso.
payment_operation	Devolverá el código asignado a esta operación en concreto	Alfanumérico	Si
authorisation_code	Código de autorización proporcionada por la entidad	Caracter (6)	Si
bank_code	Código de error por parte del banco	Caracteres	Si
pan	Tarjeta enmascarada	Numérico	Si
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox	Alfanumérico	Si

Posibles valores retornados en el campo «error_code»


error_code	Descripción
101-103	Error en el concepto
201-206	Error en el campo operation
251	La operación no coincide con el nº de comercio
252	El pago inicial no es un OK
301-303	Error en la operación inicial, no es recurrente
801	Error en la firma
901-951	Error en el identificador del comercio
999	Error inesperado

Ejemplo de petición

				
					{
"merchant_identifier":"prb",
"amount":"3",
"operation":"KX003",
"payment_operation":"468967525112", 
"payment_type":"RS", 
"description":"Concepto de prueba",
"signature":"3332a19912e757ea098b4760b46b741146fe2c4949c0fad644dae437a4b3b8d0"
}

Document KX PaymentSuite

Documentación técnica de integración

Pay by reference

Parámetros de la solicitud

Respuesta del servicio

Posibles valores retornados en el campo «error_code»

Ejemplo de petición