Recurrencia en tarjeta
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:
| Parámetro | Tipo de dato | Requerido | Descripción |
|---|---|---|---|
| merchant_identifier | Alfanumérico | Si | Identificador del cliente |
| amount | Alfanumérico | Si | Importe a cobrar, en valor entero (decimal multiplicado por 100), ejemplo 100 corresponde a 1€, 150 corresponde a 1,5€ |
| merchant_operation | Alfanumérico | Si | Código que el merchant asignará a esta operación en concreto, código interno para el cliente |
| payment_operation | Alfanumérico | Si | Código que identifica la tarjeta codigoOperacion obtenido en la captura inicial |
| payment_type | Alfanumérico | Si | Siempre llevará el valor RS |
| currency | Alfanumérico | No | Moneda de cobro, por defecto Euros, codificación según estándar ISO-4217 |
| description | Alfanumérico | No | Dato que describa el motivo del pago, a nivel informativo, no visible para el cliente final |
| signature | Alfanumérico | Si | Firma de la petición |
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:
| Parámetro | Valor |
|---|---|
| error_code | Código de error en la petición (ver tabla) |
| payment_code | Resultado del cobro (Ver tabla) |
| payment_operation | Código de operación generado por collectAR |
| authorisation_code | Código de autorización bancario |
| bank_code | Código de error retornado por el procesado |
| pan | Pan de la tarjeta sobre la que se ha realizado el cobro |
| entity_reference | Referencia original de la entidad |
| signature | Cadena de firma de esta petición |
error_code
authorisation_code
payment_operation
Clave privada
Dónde:
– ErrorCode: Es el resultado de la petición según esta tabla:
| Valor | Descripción |
|---|---|
| 101-103 | Error en el concepto |
| 201-206 | Error en el Paymentcode |
| 251 | El Paymentcode indicado no existe |
| 252 | El Paymentcode indicado no fue OK en su captura |
| 253 | El Paymentcode no soporta recurrencia |
| 301-303 | Error en el importe |
| 801 | El campo Signature no es correcto |
| 901-951 | Error en el comercio |
| 999 | Error desconocido |
- paymentCode : Es el resultado del cobro en el procesador según esta tabla:
| Valor | Descripción |
|---|---|
| 000 | Pago OK |
| 010 | Autorización OK |
| 100 | Denegador por el emisor sin dar detalle |
| 211 | Error al firmar la operación 3DS |
| 212 | Importe supera el máximo permitido |
| 213 | Operación duplicada |
| 214 | Error en el DCC |
| 300 | Pago pendiente de confirmar |
| 500 | TimeOut en procesar la operación |
| 501 | Devuelto automáticamente |
| 505 | Sin repuesta en proceso 3DS |
| 506 | La tarjeta no soporta 3DS |
| 507 | Soft declined |
| 704 | Superado el máximo de tarjetas permitidas |
| 720 | Superado importe máximo diario |
| 721 | Superado importe máximo por IP |
| 722 | Superado límite por tarjeta |
| 723 | Superado límite de pagos en tarjeta |
| 724 | Superado límite de pagos por día |
| 725 | Superado límite de pagos por IP |
| 726 | Superado Importe máximo por IP |
| 727 | Superado límite de pagos por IP auxiliar |
| 728 | Superado Importe máximo por IP Auxiliar |
| 729 | Superado límite de operaciones por IP Auxiliar |
| 732 | Tarjeta en riesgo de fraude |
| 785 | Tarjetas de Crédito no permitidas |
| 786 | Tarjetas de Empresa no permitidas |
| 787 | País de emisión de la tarjeta no permitido |
| 788 | Tarjeta en black list |
| 789 | Denegada por reglas internas de fraude |
| 797 | Denegada por filtro de BIN |
| 798 | Denegada por filtros de tarjetas |
| 799 | Denegada por ip no permitida |
| 800 | Pago sin completar (estado inicial) |
| 950 | Error en la integración del procesador |
| 999 | Error no esperado |
Ejemplo de petición
Ejecutamos el método paymentByOperation mediante una invocación POST al servicio en el entorno de test:
| Test Enviroment | https://test.imspagofacil.es/client2/rservices/paymentByOperation |
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
}