TRANXACT.AI Ayuda

Tarjetas de clientes y cargos recurrentes de tarjetas

Las tarjetas se guardan para que se pueda cobrar a los clientes según el calendario acordado; solo se muestra la marca y los últimos cuatro dígitos, están selladas y solo se descifran para crear el archivo del banco.

Suscripción, cuota mensual, plan de pago a plazos: el cliente acepta una vez y se le cobra según un calendario establecido. Contabilidad → Pagos con tarjeta gestiona los tres elementos: las tarjetas, los acuerdos para realizar los cargos y los lotes enviados al banco. Están diseñados conforme al estándar de seguridad de la industria de tarjetas (PCI DSS), por lo que el número de tarjeta es lo único en TRANXACT que nadie puede leer en una pantalla.

Tarjetas

Agregar tarjeta requiere el cliente, el número de tarjeta, la fecha de vencimiento, el nombre del titular y el código postal de facturación. A partir de ese momento, la tarjeta se muestra únicamente por su marca y sus últimos cuatro dígitos en todas partes: en pantalla, en las descargas, en ASK y en el registro de auditoría.

  • El número está sellado: cifrado con una clave propia (AES-256-GCM), y esa clave, a su vez, está cifrada con una clave de cifrado de claves que la plataforma almacena fuera de la base de datos. Una instalación de producción sin esa clave no podrá almacenar la tarjeta.
  • El código de seguridad (CVV o CVC), el PIN y los datos de la banda magnética se rechazan si se envían y nunca se almacenan.
  • La misma tarjeta añadida dos veces se reconoce y se guarda una sola vez.
  • Editar modifica la fecha de vencimiento, el nombre en la tarjeta, el código postal de facturación o el estado, pero nunca el número. Una tarjeta nueva es una tarjeta nueva: agréguela, transfiera los mandatos a ella y luego elimine la anterior.
  • La función Eliminar destruye la clave propia de la tarjeta, por lo que nadie puede recuperar el número, y cancela los mandatos asociados a ella.

mandatos de tarjetas

Un mandato es el consentimiento del cliente para que se le realicen cargos: la tarjeta, el importe y la moneda, la frecuencia (una vez, mensual, trimestral o anual), la fecha del primer cargo y, si la hay, la fecha de finalización. Se requiere el consentimiento expreso del cliente; dicho consentimiento es la base para responder a una disputa sobre un cargo. Un mandato puede pausarse, reanudarse o cancelarse.

Lotes de cargos a tarjeta

  • El sistema de cobro por mandatos realiza un único cargo por cada mandato que venza en la fecha de ejecución, y nada más: ejecutarlo de nuevo en la misma fecha no supone un doble cobro.
  • La exportación para el banco crea el archivo que recibe la entidad adquirente o el banco. Es el único lugar donde se descifra un número de tarjeta, requiere una autorización propia (Exportación por lotes de tarjetas) y cada exportación queda registrada, sin los números de tarjeta. Cargue el archivo y luego elimine su copia.
  • La respuesta del banco se registra para cada cargo: liquidado o rechazado.

¿Quién puede hacer qué?

Las tarjetas, los mandatos de tarjetas, los lotes de cargos de tarjetas, la exportación de lotes de tarjetas y la API de tarjetas (integraciones externas) se otorgan en Plataforma → Roles y autorizaciones, como en cualquier otra pantalla. ASK y a los agentes se les deniega el acceso a cualquier ruta de tarjeta, independientemente del rol que operen.

Tarjetas de tu sitio web: la API de tarjetas

Un sitio web o una aplicación que acepte una tarjeta puede almacenarla a través de una API externa, de modo que el número nunca pasa por una persona.

LlamarLo que hace
POST /api/accounting/card-api/v1/cardsAlmacena una tarjeta. Envía una cabecera Idempotency-Key: si se envía la misma clave dos veces, la tarjeta se almacena una sola vez y se devuelve la misma respuesta.
OBTENER /api/accounting/card-api/v1/cardsLas cartas, enmascaradas: marca y últimas cuatro.
PARCHE …/tarjetas/{id}La fecha de caducidad, el nombre en la tarjeta, el código postal de facturación o el estado. Nunca el número.
ELIMINAR …/tarjetas/{id}Destruye la tarjeta, al igual que lo hace la función Eliminar.
/api/contabilidad/tarjeta-api/v1/mandatosCrea y lee mandatos, utilizando una clave de idempotencia del mismo modo.
  • El usuario inicia sesión con el token de una cuenta de servicio (véase Cuentas de servicio), y el rol de dicha cuenta de servicio requiere una autorización explícita en la API de tarjetas (integraciones externas). Un rol con permisos ilimitados o un rol de administrador no son válidos: la autorización debe otorgarse por nombre.
  • En producción, las llamadas solo se aceptan a través de HTTPS.
  • Las llamadas tienen un límite de velocidad por cuenta, y una racha de tarjetas rechazadas o inválidas (el patrón de alguien que prueba números robados) bloquea la llamada.