Integración Tarjetas

  1. Introducción
  2. Integración
    1. Tarjetas
      1. Ejecución de alta de usuario en el sistema
      2. Ejecución de alta de usuario en el sistema mediante Token
      3. Alta de tarjeta física
      4. Información del usuario
      5. Actualizar expiración
      6. Eliminación del usuario
    2. Cobros
      1. Ejecución de cobro a usuario en el sistema
      2. Devolución de cobro a usuario en el sistema
      3. Información de operación
      4. Ejecución de Cobro a un usuario por Referencia
    3. Operativa DCC
      1. Introducción
      2. Ejecución de cobro a Usuario en el sistema por DCC
      3. Confirmación de moneda en pago DCC
    4. Suscripciones
      1. Ejecución de alta de suscripción a usuario en el sistema
      2. Ejecución de alta de suscripción en el sistema
      3. Modificación de suscripción en el sistema
      4. Eliminación de Suscripción
    5. Preautorizaciones
      1. Creación de una preautorización a usuario en el sistema
      2. Confirmación de una preautorización a usuario en el sistema
      3. Cancelación de una preautorización a usuario en el sistema
      4. Creación de diferida con token
      5. Confirmación de una validación de tarjeta a usuario en el sistema
      6. Cancelación de una validación de tarjeta a usuario en el sistema

Introducción

La finalidad del presente documento es servir de referencia durante el proceso de integración de un comercio con la pasarela de pagos PAYCOMET, utilizando el sistema BankStore que almacena los datos bancarios de los clientes del comercio.

El uso de algunas operativas, las relacionadas con el uso de información de tarjetas (add_user y create_subscription), supone aceptar el requerimiento por parte del cliente de someterse trimestralmente a SAQ-AEP y escaneos ASV.

Se incluye también un apéndice de referencia y se puede conseguir en la web de PAYCOMET un documento con los códigos de error devueltos por el sistema para simplificar el proceso de depuración.

Las integraciones XML y REST permiten el acceso a las operaciones de pago sin intervención directa del usuario, ampliando la operativa de cobro individual a una gestión de los datos bancarios del cliente del comercio. Las peticiones parten del servidor del comercio y son procesadas por la pasarela de pago.

Ambas tecnologías escogida para la realización de las operaciones permiten el paso seguro por firewalls y a través de la red. Si necesita la captación de los datos de tarjeta, revise las integraciones Full screen, Iframe y JET-IFRAME.

El servicio BankStore se diferencia por su comunicación entre el comercio y la pasarela aunando información sobre los datos del cliente. El comercio almacena los datos personales de su cliente y PAYCOMET los datos bancarios. Una vez el comercio da de alta el usuario PAYCOMET devuelve un identificador formado por un número único de cliente (IDUSER) y un token (TOKENUSER).

De esta forma el comercio tiene un común identificador con PAYCOMET para realizar gestiones sobre su cuenta de cliente como:

  • Alta de usuario (add_user)
  • Información de Usuario (info_user)
  • Eliminación de Usuario (remove_user)
  • Cobro de Usuario (execute_purchase)
  • Cobro de Usuario con DCC (execute_purchase_dcc)
  • Confirmación de cobro con DCC (confirm_purchase_dcc)

En el mismo servicio se ha añadido la operativa de subscripción. Esta operativa es completamente paralela a la de almacenamiento de datos bancarios del cliente. La gestión de las subscripciones se realizarán con las siguientes funciones:

  • Alta de subscripción (create_subscription)
  • Modificación de subscripción (edit_subscription)
  • Eliminación de subscripción (remove_subscription)

También están presentes las operaciones relacionadas con las preautorizaciones, a través de las funciones:

  • Alta de preautorización (create_preauthorization)
  • Confirmación de preautorizcion (preauthorization_confirm)
  • Anulación de preautorización (preauthorization_cancel)

De esta forma se dividen dos conceptos en el mismo servicio que es necesario aclarar su finalidad y diferencias:

BankStoreBankStore Subscripción
Almacenamiento de datos bancarios de cliente del comercio Gestión de subscripciones con almacenamientos de datos bancarios del cliente del comercio
Ideal para comercios con compra habitual del mismo cliente sin necesidad de volver a introducir los datos de tarjeta Ideal para subscripciones a un servicio pagos a plazos. Importante: PAYCOMET no se hará cargo de las denegaciones de cobro que pudieran ocurrir en las cuotas.
Se pueden realizar devoluciones vía XML y REST Las devoluciones deben ser realizadas desde el Panel de Control.
El alta de la subscripción puede hacerse mediante XML, REST o GET (con iframe o fullscreen). El alta de la subscripción puede hacerse mediante XML, REST o GET (con iframe o fullscreen).

Integración

Debido a que todo el proceso de pago se realiza en segundo plano (de servidor a servidor) las modificaciones a realizar en el comercio son totalmente ajenas a la experiencia de usuario.

Las tecnologías disponibles para la operativa con la pasarela de pagos PAYCOMET son SOAP y REST, ambas basadas en HTTPS para evitar problemas de transporte a través de firewalls y otros dispositivos y a la vez garantizar la seguridad de las operaciones. Existe un soporte muy amplio para la realización de llamadas con ambos protocolos para los principales lenguajes de programación usados en entornos web.

Las peticiones se realizan mediante el protocolo de transporte HTTPS, de manera que debes asegurarte de que tu sistema es capaz de realizar las peticiones correctamente y gestionar los certificados de seguridad devueltos por la plataforma para una correcta utilización.

Existen varias operaciones que se podrán lanzar desde el mismo servicio. Las operaciones disponibles vienen descritas a continuación.

Tarjetas

Ejecución de alta de usuario en el sistema

Función: (add_user)

A continuación, selecciona el tipo de integración:

REST XML GET

Ejecución de alta de usuario en el sistema mediante Token

Función: (add_user_token)

Este método permite dar de alta un usuario en base a un token obtenido previamente mediante la solución BankStore JET-IFRAME

A continuación, selecciona el tipo de integración:

REST XML GET

Alta de tarjeta física

Función: (add_user_physical)

A continuación, selecciona el tipo de integración:

REST XML GET

Información del usuario

Función: (info_user)

Esta función se utilizará para confirmar a los clientes del comercio la tarjeta a la que se le realizará el cobro. Este paso es opcional pero resulta conveniente para evitar desconfianzas.

A continuación, selecciona el tipo de integración:

REST XML GET

Actualizar expiración

Función: (edit_user)

A continuación, selecciona el tipo de integración:

REST XML GET

Eliminación del usuario

Función: (remove_user)

Esta función se utilizará para eliminar un usuario de la cuenta del comercio.

A continuación, selecciona el tipo de integración:

REST XML GET

Cobros

Ejecución de cobro a usuario en el sistema

Función: (execute_purchase)

Una vez el usuario está dado de alta en el sistema, se podrán realizar cobros a su cuenta mediante el envío de sus credenciales y datos de la operación

A continuación, selecciona el tipo de integración:

REST XML GET

Devolución de cobro a usuario en el sistema

Función: (execute_refund)

Se podrán ejecutar devoluciones de las operaciones realizadas mediante esta función. Será necesario los datos identificativos del usuario y el código de autorización bancario.

A continuación, selecciona el tipo de integración:

REST XML GET

Información de operación

Función: (operation_info)

A continuación, selecciona el tipo de integración:

REST XML GET

Ejecución de Cobro a un usuario por Referencia

Función: execute_purchase_rtoken

Este método permite ejecutar un cobro en base a un token obtenido previamente mediante la solución de Pago por Referencia

A continuación, selecciona el tipo de integración:

REST XML GET

Operativa DCC

Introducción

PAYCOMET permite mediante la operativa de BankStore, realizar transacciones en modalidad DCC (Dynamic Currency Conversion).

La conversión dinámica de moneda (DCC) convierte las compras internacionales con tarjetas de crédito de Visa® y MasterCard® en la moneda local del titular de la tarjeta. Una parte del cargo de conversión se reembolsará al comercio. PAYCOMET administra todo el proceso de conversión; desde tasas de cambios directas del tesoro y procesamiento de transacciones, a conciliación de pagos diferidos, liquidación,financiamiento y apoyo.

Con DCC, los clientes internacionales sabrán exactamente cuánto es el total de la compra en su moneda local. Las tarifas de conversión generalmente son mucho más competitivas que en las empresas de cambio.

Esta operativa debe ser activada antes de su uso, contacta con nosotros para darlo de alta al producto deseado.

La integración DCC difiere de la integración convencional por el uso de un servicio específico para realizar el cobro al cliente. Los servicios dedicados al DCC son:

  • Cobro de Usuario con DCC
  • Confirmación de cobro con DCC

El procedimiento de alta de usuario: add_user, sigue siendo necesario en el caso de compras sin 3D Secure. La diferencia principal es la incorporación de un paso adicional para recibir el cambio disponible de la moneda nativa de la tarjeta en el mismo momento de la transacción:

Ejecución de cobro a Usuario en el sistema por DCC

Función: (execute_purchase_dcc)

Una vez el usuario está dado de alta en el sistema, se podrán realizar cobros a su cuenta mediante el envío de sus credenciales y datos de la operación. La casuística del DCC requiere que un proceso de pago se realice en dos pasos: execute_purchase_dcc, donde se recibe la moneda nativa de la tarjeta (en caso que la tarjeta tenga la misma moneda que el producto asociado a la transacción, el resultado será de conversión 1:1) y posteriormente se confirmará con el método confirm_purchase_dcc con la moneda seleccionada y la sesión original de la transacción.

A continuación, selecciona el tipo de integración:

REST XML GET

Confirmación de moneda en pago DCC

Función: (confirm_purchase_dcc)

Una vez se ha devuelto el parámetro DS_MERCHANT_DCC_SESSION cuando se realizó una compra por DCC, el estado de la transacción se queda “a la espera” de la confirmación de moneda. El comercio debe proponer al cliente la moneda en la que quiere pagar (mostrándole la conversión en tiempo real) y cuando la selecciona, el comercio debe confirmar la autorización con la moneda seleccionada por el usuario final.

(ejemplo de interacción con usuario final)

A continuación, selecciona el tipo de integración:

REST XML GET

Suscripciones

Ejecución de alta de suscripción a usuario en el sistema

Función: (create_subscription_token)

El alta de una subscripción por esta vía creará una suscripción a un usuario que ya fue dado de alta en el sistema, sin que sea necesario en este caso, enviar los datos de tarjeta nuevamente.

A continuación, selecciona el tipo de integración:

REST XML GET

Ejecución de alta de suscripción en el sistema

Función: (create_subscription)

El alta de una subscripción implica el alta de un usuario en el sistema BankStore de PAYCOMET. Este proceso es completamente independiente del cobro puntual a un cliente del comercio.

A continuación, selecciona el tipo de integración:

Modificación de suscripción en el sistema

Función: (edit_subscription)

Si un usuario renueva su subscripción o simplemente se quiere aumentar la cuota del servicio, ofrecemos el servicio de modificar una subscripción. En este caso no se podrá cambiar la moneda ni los datos bancarios del cliente del comercio. La modificación de la subscripción implica el previo alta de un usuario en modo subscripción en el sistema BankStore de PAYCOMET. Este proceso es completamente independiente del cobro puntual a un cliente del comercio.

A continuación, selecciona el tipo de integración:

REST XML GET

Eliminación de Suscripción

Función: (remove_subscription)

Esta función se utilizará para eliminar una subscripción de la cuenta del comercio.

A continuación, selecciona el tipo de integración:

REST XML GET

Preautorizaciones

Creación de una preautorización a usuario en el sistema

Función: (create_preauthorization)

Una vez el usuario está dado de alta en el sistema, se podrán realizar operaciones de preautorización mediante el envío de sus credenciales y datos de la operación.

A continuación, selecciona el tipo de integración:

REST XML GET

Confirmación de una preautorización a usuario en el sistema

Función: (preauthorization_confirm)

Una vez realizada y autorizada una operación de preautorización, puede confirmarse para realizar el cobro efectivo dentro de los 7 días siguientes; pasada esa fecha, las preautorizaciones pierden su validez. El importe de la confirmación de preautorización puede ser menor, igual o superior en un 15% al de la preautorización original.

A continuación, selecciona el tipo de integración:

REST XML GET

Cancelación de una preautorización a usuario en el sistema

Función: (preauthorization_cancel)

Una vez realizada una preautorización, puede cancelarse la misma dentro de los 7 días siguientes.

A continuación, selecciona el tipo de integración:

REST XML GET

Creación de diferida con token

Función: (create_preauthorization_deferred)

Una vez realizada una preautorización, puede cancelarse la misma dentro de los 7 días siguientes.

A continuación, selecciona el tipo de integración:

REST XML GET

Confirmación de una validación de tarjeta a usuario en el sistema

Función: (deferred_preauthorization_confirm)

Una vez realizada y autorizada una operación de validación de tarjeta., puede confirmarse para realizar el cobro efectivo dentro de las 72 horas siguientes; pasada esa fecha, las preautorizaciones diferidas pierden su validez. El importe de la confirmación de validación de tarjeta debe ser exactamente igual al de la validación de tarjeta original.

A continuación, selecciona el tipo de integración:

REST XML GET

Cancelación de una validación de tarjeta a usuario en el sistema

Función: (deferred_preauthorization_cancel)

Una vez realizada una validación de tarjeta, puede cancelarse la misma dentro de las 72 horas siguientes.

A continuación, selecciona el tipo de integración:

REST XML GET