Skip to main content

​
¿Qué es el SDK de la Terminal?

El SDK de la Terminal, llamado PayCode Connect, permite que una aplicación se comunique de forma directa con una terminal física PayCode (TPV), sin depender de un servidor intermedio. La comunicación ocurre en una red punto a punto (P2P) entre el dispositivo donde corre tu aplicación y la terminal, lo que hace posible enviar comandos y recibir eventos en tiempo real. Con PayCode Connect tu aplicación puede, entre otras cosas:
  • Iniciar y controlar transacciones EMV (pago con tarjeta) directamente desde tu software.
  • Recibir el resultado de cada transacción en tiempo real, incluyendo el estado del proceso (esperando tarjeta, procesando, aprobado, error).
  • Usar la terminal como lector de códigos de barras.
  • Reimprimir o revertir transacciones anteriores.
  • Detectar si la conexión con la terminal se perdió, y recuperar transacciones que quedaron sin confirmar.

​
¿Para qué sirve?

Este mecanismo está pensado para negocios que ya tienen (o están construyendo) su propio software de punto de venta y que necesitan integrarlo directamente con el hardware de PayCode, en lugar de depender de la interfaz que trae la terminal por defecto. Es la opción indicada cuando el negocio quiere:
  • Disparar un cobro desde su propio sistema (por ejemplo, al cerrar una cuenta o un pedido).
  • Mostrar el estado de la transacción dentro de su propia interfaz, en vez de que el cliente solo vea la pantalla de la terminal.
  • Asociar cada transacción con datos propios del negocio (número de mesa, folio de orden, etc.) usando metadata.
  • Automatizar procesos como reimpresión de tickets o reversión de pagos desde su software.

​
¿Quién lo puede usar?

PayCode Connect requiere que el negocio cuente con una terminal física PayCode y con un equipo de desarrollo propio (interno o un proveedor externo) capaz de integrar un SDK en su aplicación. No es una integración pensada para negocios que solo quieren cobrar en línea; para eso existen los mecanismos de Payment Link, Checkout Elements o Full API. Actualmente PayCode Connect está disponible en dos lenguajes, según el tipo de aplicación que tenga el negocio:

C#/.NET

Para aplicaciones de escritorio en Windows, construidas con WPF, WinUI, UWP o MAUI.

TypeScript

Para aplicaciones web que necesitan comunicarse con una terminal PayCode desde el navegador.
Existen también versiones internas del SDK en Rust, Kotlin y C, pensadas para Android y otras plataformas. Por ahora no están documentadas públicamente; si tu proyecto lo requiere, contacta a tu ejecutivo de cuenta en PayCode.

​
Cómo funciona, en resumen

El flujo de integración es el mismo sin importar el lenguaje:
  1. Setup: se inicializa el SDK en el dispositivo del negocio, creando un nodo local.
  2. Conexión: se genera un código QR que la terminal escanea para establecer la conexión P2P.
  3. Eventos y comandos: una vez conectados, la aplicación puede enviar comandos (como iniciar un cobro) y suscribirse a eventos (como el estado de la transacción o la presencia de la terminal).
Los detalles específicos de instalación y código varían según el lenguaje, así que revisa la guía correspondiente a tu stack.