Ir al contenido principal

Registrar y desregistrar terminal de pago

H
Escrito por Haakon Lageng

ProClinic Pay utiliza Surfboard Payments para terminales físicas y SoftPOS (Tap to Pay). Las terminales deben asociarse a la tienda de la clínica en Surfboard antes de poder usarlas en caja.

¿Dónde hago esto?

  • Clínica: Configuración → Pagos (/dashboard/settings/payments)

  • SoftPOS puede ser añadido o eliminado por la propia clínica

  • Terminal física: la clínica puede registrar terminal usando PIN; la desregistración del hardware físico la realiza ProClinic (superadministrador)

Registrar SoftPOS (Tap to Pay)

  1. Abre Configuración → Pagos.

  2. Selecciona añadir nueva terminal.

  3. Escribe un nombre para la terminal (por ejemplo, «iPhone Recepción»).

  4. Introduce el código de registro de 6 dígitos (PIN de la clínica) que aparece en la app de SoftPOS/CheckoutX.

  5. Completa el registro.

Después de un registro exitoso, la terminal aparece en la lista y ya puede usarse en caja (a menos que esté oculta).

Registrar una terminal de pago física

Antes de empezar

  • La terminal debe estar encendida y tener conexión (WiFi o datos móviles).

  • Ten a mano el número de serie (suele estar al dorso del dispositivo; consulta también las imágenes de ayuda en la tarjeta lateral).

  • Necesitas el código de registro de 6 dígitos (PIN) que la terminal mostrará en modo de registro.

Pasos en la terminal (SurfTouch / similar)

  1. Activa el roaming/datos móviles si tu clínica utiliza SIM (sigue las capturas del manual de registro).

  2. Enciende el modo de registro en la terminal.

  3. Apunta el PIN que se muestra.

Pasos en ProClinic

  1. Ve a Configuración → Pagos.

  2. Añade una nueva terminal.

  3. Rellena:

    • Nombre

    • PIN de 6 dígitos (código de registro)

    • Número de serie

  4. Confirma.

ProClinic conecta con Surfboard para registrar el dispositivo en la tienda de la clínica. Si el registro es exitoso, se guarda el terminalId localmente y podrás establecer la terminal como predeterminada u ocultarla de la caja según necesites.

Las imágenes guía están disponibles en /images/register-terminal/ (los mismos pasos que en la pestaña "Info" de la tarjeta lateral).

Desregistrar SoftPOS

  1. Ve a Configuración → Pagos.

  2. Busca la terminal SoftPOS en la lista.

  3. Selecciona eliminar/quitar y confirma.

El sistema desvincula la terminal de la tienda en Surfboard (POST /terminals/deactivate) y la marca como desregistrada en ProClinic (unregisteredAt). Desaparece de la caja, pero permanece en el historial para facturación durante el mismo mes.

Desregistrar una terminal física

La clínica puede ocultar una terminal física de la caja, pero no puede desvincularla de Surfboard por su cuenta.

ProClinic (superadministrador) realiza el desregistro del hardware físico en Surfboard con el comando POST /terminals/deactivate (desvinculación de la tienda) y marca la terminal como desregistrada en ProClinic.

Usar una terminal en otra clínica

Si el registro por PIN falla en la nueva clínica (por ejemplo, si la terminal sigue asociada al antiguo comercio), ProClinic intenta automáticamente:

  1. Registrar con PIN

  2. Si falla: ejecuta move (asocia el número de serie al merchantId de la clínica), luego registra PIN de nuevo

  3. Si aún falla: ejecuta ship-hardware (número de serie + merchantId), luego registra PIN una vez más

Por eso es obligatorio ingresar el número de serie al registrar una terminal física.

Terminal de pago externa (por ejemplo Nets)

Las terminales de otros proveedores no pueden registrarse en ProClinic. Si usas tu propia terminal de Nets para cobrar con tarjeta, activa Usar terminal de pago externa en Configuración → Pagos. Cobras en tu propia terminal y confirmas la venta en la caja con Pagado en sistema externo.

Consulta Caja y pagos para ver cómo se comportan la caja y los informes con este ajuste.

Errores frecuentes

  • PIN no válido: El código es de 6 dígitos y hay que obtener uno nuevo si ha expirado.

  • Configuración de Surfboard incompleta: La clínica necesita tener surfboardMerchantId y surfboardStoreId antes de registrar o desregistrar terminales.

  • La terminal física no puede ser eliminada por la clínica: Contacta con el soporte de ProClinic para desregistrarla.

  • Ya desregistrada: La terminal ya tiene unregisteredAt y no puede desregistrarse otra vez.

Solicita ayuda en el chat

Puedes escribir: ¿Cómo registro una terminal de pago? o ¿Cómo elimino SoftPOS?

¿Ha quedado contestada tu pregunta?