Integración Tarjetas
- Introducción
-
Integración
- Tarjetas
- Ejecución de alta de usuario en el sistema
- Ejecución de alta de usuario en el sistema mediante Token
- Alta de tarjeta física
- Información del usuario
- Actualizar expiración
- Eliminación del usuario
- Cobros
- Ejecución de cobro a usuario en el sistema
- Devolución de cobro a usuario en el sistema
- Información de operación
- Ejecución de Cobro a un usuario por Referencia
- Operativa DCC
- Suscripciones
- Ejecución de alta de suscripción a usuario en el sistema
- Ejecución de alta de suscripción en el sistema
- Modificación de suscripción en el sistema
- Eliminación de Suscripción
- Preautorizaciones
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 (addUser y createSubscription), 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.
La integración REST permite 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.
Está tecnología escogida para la realización de las operaciones permite 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 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
(addUser)
- Información de Usuario
(infoUser)
- Eliminación de Usuario
(removeUser)
- Cobro de Usuario
(executePurchase)
- Cobro de Usuario con DCC
(dccPurchaseCreate)
- Confirmación de cobro con DCC
(dccPurchaseConfirm)
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
(createSubscription)
- Modificación de subscripción
(editSubscription)
- Eliminación de subscripción
(removeSubscription)
Importante
Las suscripciones no se ejecutan en cuentas sandbox.
Las suscripciones se pueden programar, modificar y eliminar pero en cuentas sandbox no se ejecutarán.
También están presentes las operaciones relacionadas con las preautorizaciones, a través de las funciones:
- Alta de preautorización
(createPreauthorization)
- Confirmación de preautorizcion
(preauthorizationConfirm)
- Anulación de preautorización
(preauthorizationCancel)
De esta forma se dividen dos conceptos en el mismo servicio que es necesario aclarar su finalidad y diferencias:
BankStore | BankStore 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 REST | Las devoluciones deben ser realizadas desde el Panel de Control. |
El alta de la subscripción puede hacerse vía REST. | El alta de la subscripción puede hacerse vía REST. |
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.
La tecnología disponible para la operativa con la pasarela de pagos PAYCOMET es REST, basada 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 este protocolo 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: (addUser
)
Importante
El uso de esta opción supone aceptar el requerimiento por parte del cliente de someterse trimestralmente a SAQ-AEP y escaneos ASV.
Consultar documentación REST
Ejecución de alta de usuario en el sistema mediante Token
Función: (addUserToken
)
Este método permite dar de alta un usuario en base a un token obtenido previamente mediante la solución BankStore JET-IFRAME
Consultar documentación REST
Alta de tarjeta física
Función: (physicalAddCard
)
Consultar documentación REST
Información del usuario
Función: (infoUser
)
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.
Consultar documentación REST
Actualizar expiración
Función: (editUser
)
Consultar documentación REST
Eliminación del usuario
Función: (removeUser
)
Esta función se utilizará para eliminar un usuario de la cuenta del comercio.
Consultar documentación REST
Cobros
Ejecución de cobro a usuario en el sistema
Función: (executePurchase
)
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
Consultar documentación REST
Devolución de cobro a usuario en el sistema
Función: (executeRefund
)
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.
Consultar documentación REST
Información de operación
Función: (operationInfo
)
Consultar documentación REST
Ejecución de Cobro a un usuario por Referencia
Función: (executePurchaseRtoken
)
Este método permite ejecutar un cobro en base a un token obtenido previamente mediante la solución de Pago por Referencia
Consultar documentación REST
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. 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: addUser
, 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: (dccPurchaseCreate
)
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: dccPurchaseCreate
, 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 dccPurchaseConfirm
con la moneda seleccionada y la sesión original de la transacción.
Consultar documentación REST
Confirmación de moneda en pago DCC
Función: (dccPurchaseConfirm
)
Una vez se ha devuelto el parámetro dcc{sesion}
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)
Consultar documentación REST
Suscripciones
Ejecución de alta de suscripción a usuario en el sistema
Función: (createSubscription
)
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.
Consultar documentación REST
Modificación de suscripción en el sistema
Función: (editSubscription
)
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.
Consultar documentación REST
Eliminación de Suscripción
Función: (removeSubscription
)
Esta función se utilizará para eliminar una subscripción de la cuenta del comercio.
Consultar documentación REST
Preautorizaciones
Creación de una preautorización a usuario en el sistema
Función: (createPreauthorization
)
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.
Consultar documentación REST
Confirmación de una preautorización a usuario en el sistema
Función: (confirmPreauthorization
)
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 sin exceder en un 15% la preautorización original.
Consultar documentación REST
Cancelación de una preautorización a usuario en el sistema
Función: (cancelPreauthorization
)
Una vez realizada una preautorización, puede cancelarse la misma dentro de los 7 días siguientes.
Consultar documentación REST