Terminal

Abre el enlace en un móvil o una tablet, teclea el importe en el teclado numérico y pasa el dispositivo al cliente. Cuando el pago se confirma, la página vuelve sola al teclado numérico, lista para la siguiente venta.

Terminal funciona tal cual. Sin código, sin claves de API incrustadas, sin servidor. La marca, la moneda y las redes activas se heredan de los ajustes del proyecto.

Dónde encontrar la URL del Terminal

El terminal depende del método de integración del proyecto. Se elige al crear el proyecto y después ya no cambia, así que no hay ningún interruptor que activar: o el proyecto se creó como Terminal y tiene su URL, o hace falta crear otro proyecto con ese método.

1. Elige en el panel el proyecto de ese mostrador.
2. Abre la página Terminal.
3. Copia la URL del terminal de la tarjeta Acceso al terminal.

La URL tiene este aspecto:

https://paymos.io/terminal?key=pk_live_xxx&pid=prj_yyy

Comparte el enlace con el personal de caja o guárdalo en los marcadores del dispositivo del mostrador.

La dirección antigua /pos sigue respondiendo: redirige a /terminal conservando key y pid, de modo que un marcador guardado en el dispositivo de caja no se rompe a media jornada. Para repartir el enlace hoy, usa ya la forma con /terminal.

Qué contiene la URL

Parámetro	Para qué sirve
key	Clave pública del proyecto (prefijo pk_live_ o pk_test_). No es secreta, pero quien la tenga puede crear facturas contra tu proyecto. Se toma de la clave de pago activa del proyecto.
pid	Identificador del proyecto (prefijo prj_). Decide qué tokens, qué redes y qué marca se cargan.

La URL no está ligada a ningún dispositivo: ábrela en cualquier navegador. Cada apertura es una sesión independiente.

Cómo transcurre una venta

• 01El cajero abre la URL del Terminal en un navegador (móvil o tablet).
• 02Elige la moneda fiat (USD, EUR, RUB y otras 43) y teclea el importe en el teclado numérico.
• 03Pulsa Cobrar: el terminal crea una factura y abre la página de pago habitual.
• 04El cliente paga desde su propio dispositivo: escanea el QR de la pantalla del terminal o sigue el enlace.
• 05Una vez confirmado en cadena, el terminal vuelve solo al teclado numérico.

El cajero no toca ninguna billetera. El cliente no se registra en Paymos. Casi toda la espera es la confirmación en cadena: segundos en una cadena de finalidad rápida y unos minutos para un pago grande en una más lenta.

Personalizar el aspecto

Terminal hereda los mismos ajustes de marca que la página de pago normal. Se editan en la tarjeta Marca de la página Formulario de pago del panel:

Ajuste	Qué cambia
Estilo de la página de pago	Plantilla de estilo base de la página de pago (patrón de fondo, tema)
Acento	Color principal: botones, enlaces, hover, indicador de red activa
Fondo	Fondo de la página
Superficie	Superficie de tarjetas y paneles
Texto	Texto principal
Atenuado	Texto secundario (pistas, pies de texto)
Radio de las esquinas	Redondeo de botones y tarjetas, 0-32 px

Al guardar, la vista previa de esa misma página se actualiza sola. El Terminal recoge los cambios en la siguiente apertura.

Logotipo

El logotipo del proyecto aparece en la cabecera del Terminal. Se sube como archivo desde la página de detalle del proyecto, no desde la lista de proyectos: el selector admite PNG, JPEG y WebP, con un máximo de 2 MB por archivo. Los SVG se rechazan.

Lista de monedas

El Terminal muestra las monedas fiat activadas en el proyecto, en la pestaña Monedas de la página de detalle del proyecto. El conjunto de partida para comercio minorista es USD, EUR, RUB. Añade o quita las que encajen con tu geografía.

Redes y tokens activos

El Terminal solo enseña al cliente las redes y los tokens activados en la pestaña Monedas del proyecto. Una mezcla habitual en comercio minorista:

• Tron (USDT) — clientes de la CEI y Asia
• Polygon (USDC/USDT) — comisión baja para el cliente
• BSC (USDT) — usuarios nativos de Binance
• TON — públicos nativos de Telegram

Deja activada la red principal de Ethereum si esperas ventas de importe alto.

Sandbox y producción

El prefijo de la clave en la URL del Terminal decide el entorno: pk_test_ para Sandbox y pk_live_ para producción. En Sandbox, el Terminal muestra en la cabecera un banner ámbar con la palabra Sandbox.

Para hacer pruebas:

1. Genera una clave pk_test_ en Panel → Desarrollador → Claves de API.
2. Construye la URL del Terminal de Sandbox (misma forma, clave de prueba).
3. Paga las facturas desde billeteras de testnet.

Para pasar a producción, crea una clave pk_live_ y actualiza la URL en los dispositivos del mostrador.

Terminal como recurso del Low-Code SDK

Si usas el Low-Code SDK sin importe fijo (sin amount), pasa la URL del Terminal en la opción pos_url del SDK: el widget abrirá entonces el Terminal en lugar del formulario de pago habitual. Un solo widget cubre dos flujos:

• Importe fijo — el cliente paga el importe establecido con el formulario habitual.
• Importe libre — el cliente teclea el importe en el teclado numérico del Terminal.

Un script, dos modos, sin compilación aparte. Sin pos_url no hay recurso alternativo: una pulsación sin importe resoluble genera un evento paymos:error en vez de abrir el Terminal.

Varios cajeros o dispositivos

La URL es compartida. Ábrela en tantos dispositivos como necesites: todos funcionan en paralelo contra el mismo proyecto. Las transacciones se acumulan en el historial común del proyecto y el panel lo muestra todo.

Varios locales

Crea un proyecto por local:

1. Panel → Proyectos → Nuevo proyecto, con Terminal como método de integración.
2. Configura la marca y las redes activas.
3. Copia la URL del terminal de ese local.

Todos los proyectos cuelgan de una misma cuenta de comercio: los informes se agregan en el panel común.

Seguridad

La key de la URL es la clave pública. No da acceso a los retiros, a los ajustes del proyecto ni a ninguna operación restringida. Lo que sí permite es crear facturas contra tu proyecto.

En la práctica:

• La URL del Terminal se puede dejar sin riesgo en los marcadores de un dispositivo de mostrador a la vista.
• Si la URL se filtra a alguien de fuera, esa persona puede crear facturas (pero no pagarlas por ti ni retirar fondos).
• Si se ve comprometida, genera una clave pk_live_ nueva en Panel → Desarrollador → Claves de API y actualiza la URL. Revoca la clave antigua.

Resolución de problemas

El Terminal no se abre

Comprueba:

1. Que la URL lleva los dos parámetros: key y pid.
2. Que el proyecto se creó con Terminal como método de integración.
3. Que la clave no está revocada en Desarrollador → Claves de API.

La página dice «Cobro no disponible»

Ese único mensaje cubre todas las causas de credenciales: falta key o pid, la clave no es válida o está revocada, el proyecto no existe, o su método de integración no es Terminal. Copia otra vez la URL desde la página Terminal del panel. Si el proyecto se creó con otro método, no tiene terminal: crea uno nuevo con el método correcto.

No aparece el QR tras pulsar «Cobrar»

Comprueba que hay al menos un token activado en la pestaña Monedas del proyecto.

El pago no se confirma

La profundidad de confirmación depende de la red y del importe del pago: los importes pequeños pasan rápido y los grandes esperan más a la finalidad. Las cadenas con finalidad nativa rápida (BSC, Polygon, Solana, Avalanche, Plasma) liquidan en segundos; en Tron, Ethereum y las L2 un pago grande puede tardar un par de minutos. Si el cliente pagó hace varios minutos y la página no se mueve, abre la transacción en el explorador de la red para comprobar que llegó.

El Terminal se ve roto tras cambiar el tema

En la pestaña abierta sigue el tema antiguo en la caché. Cierra la pestaña y vuelve a abrir la URL para cargar el nuevo.