Terminal Integrada

Qué es la terminal integrada

Si tu negocio funciona sobre otro programa - un gestor de consultorio, un paquete contable, un sistema de reservas - la terminal integrada pone tu terminal virtual completa de Merchant360 dentro de ese programa. Tu personal abre la página de terminal en el software que ya usa, y todo funciona exactamente como la real: pagos con tarjeta y con cheque (ACH), tu dual pricing, tarjetas guardadas de tu bóveda y recibos por correo. Cada cobro se deposita en tu propia cuenta de comerciante, como siempre.

La empresa de software (o tu desarrollador web) hace la integración con un pequeño fragmento de código; tú mantienes el control porque todo funciona con una llave que TÚ creas, restringes y puedes apagar en cualquier momento.

La integración se muestra limpia por defecto: solo la tarjeta de la terminal con una pequeña marca “Payments powered by Merchant360” bajo el botón de pago, para que encaje naturalmente en cualquier producto. Si el software anfitrión quiere mostrar el nombre de tu negocio arriba de la terminal, puede agregar &header=1 a la dirección de integración.

¿Tienes lectores Handpoint? La integración ofrece un modo de dispositivo automáticamente: tu personal elige un lector (o queda fijo al suyo asignado) y el cliente acerca o inserta su tarjeta en la terminal física - la tarjeta nunca toca el software anfitrión.

Crear una llave de integración

Ve a Herramientas de cobro → Configuración y abre la tarjeta Terminal integrada. Crea una llave y asígnale las direcciones web donde puede funcionar - por ejemplo tusoftware.com. La llave se muestra una sola vez; cópiala y entrégasela al proveedor de software o al desarrollador que hará la integración.

1. 1Herramientas de cobro → Configuración → Terminal integrada → Crear llave.
2. 2Escribe el o los dominios donde puede aparecer la terminal. Una entrada *.ejemplo.com cubre todos los subdominios.
3. 3Copia la llave ahora - por seguridad solo la mostramos esta única vez.
4. 4Entrega la llave y la dirección de integración a tu proveedor de software o desarrollador.

Llaves de prueba

Crea una llave de prueba (empieza con vtk_test_) y el proveedor puede construir y demostrar toda la integración sin un solo cobro real. Cuando todo se vea bien, cambia a una llave en vivo - nada más cambia.

Dónde aparecen los pagos

Los cobros hechos por la terminal integrada son tus pagos normales: aparecen en Transacciones, se liquidan en tus lotes y siguen tu dual pricing y tus reglas antifraude como cualquier otro cobro de la terminal virtual. Los recibos también salen a nombre de tu negocio.

Para el proveedor de software: recuperar los pagos

El software anfitrión normalmente quiere los pagos de vuelta para sus propios reportes. Dos formas, ambas bajo Desarrolladores en Merchant360:

1. 1Webhooks: registra un webhook y Merchant360 envía los eventos de pago (cobro exitoso, reembolso y más) al software en el momento en que ocurren, firmados para que el software verifique que son reales.
2. 2API de reportes: el software también puede consultar transacciones por su cuenta con una llave API de Merchant360: listar pagos, buscar uno, filtrar por fecha - todo lo necesario para mostrar y conciliar la actividad dentro de su producto.