Documentación Collectar

Documentación Collectar

Documentación técnica de integración

Recurrencia en tarjeta

Estimated reading: 4 minutes 134 views

Este servicio nos permitirá realizar un cobro automático sobre una tarjeta capturada previamente mediante el método de cobro factura (apartado 4) o cobro normal (apartado 5). Previamente en la configuración se debe activar que este comercio permite recurrencia.

En este caso se trata de realizar una captura de tarjeta a través de la web o a través de un enlace
enviado por email, sms u otro canal y posteriormente realizar cobros de importe variable.
A través de la operativa de firma de contrato se puede utilizar para capturar la tarjeta a la vez que el contrato de alta y posteriormente realizar los cobros desde este servicio.

La principal ventaja para el comercio es que el controla en que momento quiere realizar el cobro.
Es importante en el proceso de captura avisar al usuario de que su tarjeta será capturada y utilizada para realizar cobros posteriormente de forma automática. Cumpliendo con la normativa PSD2 ésta operativa se realizará siempre forzando una captura como segura aplicando SCA, de
esta forma el resto de cobros serán vinculados siempre con esta operativa segura.

Cuando realicemos la captura de la tarjeta debemos guardar en nuestro sistema el campo codigoOperacion vinculado al usuario, este código lo obtendremos en la respuesta del pago de cualquiera de los métodos disponibles.

Debemos tener en cuenta que sólo puedo hacer cargos sobre una tarjeta capturada positivamente, en caso
de denegación no podría hacer recurrencia sobre esa tarjeta. La captura puede hacerse por un importe
concreto o por 0€ si sólo quiere dejar guardada la tarjeta para futuros pagos.

Parámetros de entrada

El servicio recibe los siguientes parámetros:

El campo firma se compondrá mediante el siguiente proceso. Para ellos se generará una cadena concatenados los siguientes valores:

merchant_identifier
amount
merchant_operation
payment_operation
Clave privada

Sobre esta cadena, aplicaremos una función SHA 256 y el resultado será codificado en una cadena hexadecimal (en Minúsculas)

firma = upper(hex(sha256(cadena de firma)))

El resultado de esta función es el valor a enviar en el campo firma

Parámetros de salida

El servicio devolverá un mensaje JSON con los siguientes campos:

El campo firma se compondrá mediante el siguiente proceso. Para ellos se generará una cadena concatenados los siguientes valores:

error_code
authorisation_code
payment_operation
Clave privada

Dónde:

– ErrorCode: Es el resultado de la petición según esta tabla:

  • paymentCode : Es el resultado del cobro en el procesador según esta tabla:

Ejemplo de petición

Ejecutamos el método paymentByOperation mediante una invocación POST al servicio en el entorno de test:

Con el siguiente cuerpo: 

				
					{
"merchant_identifier":"CollectAR",
"amount":100,
"merchant_operation":"111",
"payment_operation":"320040911420",
"payment_type":"RS",
"description":"Concepto de prueba",
"currency":"987",
"signature":"6321608fe25dca466491ae7b995715c13a67338a7b9216faa73ca2b083c184aa"
}

				
			

El campo firma se ha compuesto de la siguiente manera:

Creamos la cadena de firma:

– CollectAR100111320040911420123348c4-6c0c-4985-8a36-f27127729b29

Generamos el hash para esa cadena, lo convertimos a una cadena hexadecimal :

– 49abb849a147b9ea4dca499c5c9271ee1d8852f82f2df1ab1a48f9a2c7510e82

Respuesta a una petición

La petición anterior devolverá una respuesta JSON con el siguiente contenido:

Correcta: 

				
					{
 "error_code": 000,
 "payment_code": 000,
 "payment_operation": 138492842,
 "authorisation_code": 12B333,
 "signature": "6fdd14e146d2d82d16c0c4cf2298b5e858d567d71a3b2e90d176b9ad0c0be4ad",
 "bank_code": 000,
 "entity_reference": 8833,
 "pan": 111111xxxxxx1411
}

				
			

Con error: 

				
					{
 "error_code": 801,
 "payment_code": null,
 "payment_operation": null,
 "authorisation_code": null,
 "signature": "6fdd14e146d2d82d16c0c4cf2298b5e858d567d71a3b2e90d176b9ad0c0be4ad",
 "bank_code": null,
 "entity_reference": null,
 "pan": null
}

				
			
CONTENTS
es_ESEspañol