Captura

Lectura estimada: 2 minutos

Esta sección detalla el proceso de captura de una autorización previa

La solicitud se realiza a través de un servicio web de tipo REST con un dato en formato JSON. 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/capture
Production Enviroment	https://imspagofacil.es/client2/rservices/v1/capture

Parámetros de solicitud

Parámetro	Descripción
merchant_identifier	Código que identifica al comercio en la pasarela de pagos.
amount	Cantidad a ser capturada
operation	Identificador de la operación del pago a ser capturado
transaction_type	Tipo de operación
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kineox

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 ,operation, amount, 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 de la solicitud fueran 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.
operation	Operación de pago	Caracteres (12)	No, solo 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 proporcionada por la entidad	Caracter (6)	No, sólo se informará si el reeembolso ha sido exitoso
amount	Cantidad del pago	Numérico. Será multiplicado por 100 para evitar enviar separadores decimales; un pago de €14,70, será enviado como 1470	Sí
pan	Datos de la tarjeta en formato pan	Numérico	Sí
bank_operation	Operación bancaria	Caracteres	Sí
signature	Firma de los parámetros enviados con la contraseña proporcionada por Kíneox	Alfanumérico	Sí

-merchant_identifier ,operation, amount, 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
000	No hay ningún error
251	Identificador de la operación no existe
252	El pago a ser capturado, no se encuentra autorizado.
253	El pago a capturar no está habilitado para capturar
302	Error en la cantidad, es mayor que la cantidad inicial autorizada
801	Error en la firma
901	Comerciante inválido
911	Comerciante no activado
999,999	Error inesperado

Códigos de retorno asociados con el campo payment_code

payment_code	Descripción
000	Operación Ok
Cualquier otro valor	Operación Ko

Ejemplo de petición

				
					{
    "merchant_identifier":"prb",
    "operation":"168967543264",
    "amount": "100",    
    "transaction_type":"CAPTURE",
    "signature":"06a26161704f79da1695d4ac75e611809cef04bbb0afa6221fe219a0fe96b526"
}

Documentación KX PaymentSuite

Documentación técnica de integración