ATH Móvil es la forma más popular de pagar entre comercios y consumidores en Puerto Rico. Con GlobalSuite PR, tus clientes pueden pagar tus facturas usando su app ATH Móvil — el pago llega a tu pATH y la factura se marca como Pagada automáticamente, en cuestión de segundos.
Es la app de pagos más usada en Puerto Rico, con más de 2 millones de usuarios. Tus clientes ya la tienen instalada y la usan todos los días. Aceptarla aumenta tus pagos cobrados a tiempo y reduce la fricción de tener que pedir tarjetas o ACH.
Parte 1 — Crear tu cuenta ATH Business
Si ya tienes ATH Business activo con un pATH funcional, salta a la Parte 2.
Descarga la app ATH Business
Búscala en el App Store (iOS) o Google Play (Android) como ATH Business. Es una app diferente a ATH Móvil personal — esta es exclusiva para comerciantes.
Regístrate con tu información de negocio
La app te pedirá:
- Nombre de tu negocio
- Email y teléfono
- Tarjeta ATH del banco donde quieres recibir los pagos (FirstBank, BPPR, Oriental, cooperativas, etc.)
Crea tu pATH
El pATH es el nombre único de tu negocio en ATH Móvil — algo como /MiNegocio o /PaneliaPedro. Tiene entre 3 y 25 caracteres y es como te identifican tus clientes para pagarte.
Espera la verificación
ATH Business verifica tu cuenta en 5 días hábiles o menos. Hasta que esté verificada, tu pATH no aparece en la lista pública de negocios y no puedes recibir pagos.
Tu cuenta ATH Business necesita una tarjeta ATH (débito) registrada y activa de un banco participante. Si tu tarjeta es de BPPR, llama al 787-756-3939 para validarla antes de empezar.
Parte 2 — Obtener tus API Tokens
Para conectar ATH Móvil con GlobalSuite PR necesitas dos tokens: un Public Token y un Private Token. Estos los genera la app ATH Business automáticamente.
Abre la app ATH Business
Inicia sesión en tu cuenta de comerciante.
Ve a Settings → Botón de Pago
En el menú de configuración (ícono de engranaje), busca la opción Botón de Pago o Payment Button.
Copia los tokens
Public Token — un código de 40 caracteres que identifica tu negocio. Es seguro usarlo en la configuración del módulo.
Private Token — otro código que se requiere para procesar reembolsos vía API. Trátalo como una contraseña — no lo compartas ni lo expongas en conversaciones de soporte.
Si recibes el error BCUS_0092: ATH Movil Business unavailable al intentar usar el módulo, significa que tu cuenta aún no está habilitada para procesar pagos via API. Contacta soporte de Evertec al 787-773-5466 o ath.business/botondepago para que activen el acceso a la API REST.
Parte 3 — Conectar en GlobalSuite PR
Ve a Settings → Payment Gateways
En el panel de administración: ⚙️ Setup → Settings → Payment Gateways.
Busca el tab "ATH Móvil"
Haz click en el tab ATH Móvil en la lista de métodos de pago disponibles.
Pega tus tokens
Ingresa tu Public Token y Private Token copiados desde ATH Business. Activa el método de pago y guarda los cambios.
Prueba con una factura real
Crea una factura de prueba y págala desde un teléfono con ATH Móvil cuyo número sea diferente al de tu cuenta ATH Business. Verifica que la factura cambia a estado Paid automáticamente.
A partir de ahora, cada factura que envíes incluirá la opción de pagar con ATH Móvil. Cuando tu cliente autorice el pago en su app, el dinero llega a tu pATH inmediatamente y la factura se marca como Paid automáticamente. Cero intervención manual.
Dashboard de transacciones
GlobalSuite PR incluye un dashboard exclusivo para tus transacciones de ATH Móvil. Lo encuentras en el menú lateral como ATH Movil.
Ahí puedes ver y hacer:
- Estadísticas en tiempo real: total de transacciones, completadas, pendientes, canceladas, reembolsadas
- Monto procesado en los últimos 30 días
- URL de tu webhook (para registrar en ATH Business como respaldo)
- Tabla de transacciones recientes con factura, monto, teléfono del cliente, status y reference number de Evertec
- Event log de los últimos 20 eventos — cada paso de cada transacción registrado con timestamp e IP
- Exportar logs — descarga todos los eventos como archivo CSV para análisis externo
- Limpiar logs (solo admins) — elimina eventos acumulados cuando la tabla crece demasiado
Al hacer click en una transacción individual, verás su detalle completo incluyendo:
- ecommerceId y referenceNumber de Evertec (con y sin guión)
- Historial de eventos con payload colapsable — click en "ver completo ▼" para expandir el JSON de diagnóstico de cada evento
- Botón para descargar el log de esa transacción como archivo
.txtcon el JSON pretty-printed - Botón para limpiar el log individual (solo admins)
Procesar reembolsos
Puedes procesar reembolsos completos o parciales directamente desde el dashboard. El sistema verifica el estado real de la transacción en Evertec antes de intentar el reembolso.
Ve al dashboard de ATH Movil
Sidebar → ATH Movil.
Localiza la transacción
En la tabla de transacciones recientes, busca la transacción que quieres reembolsar (debe estar en status Completed). Haz click en Detalle para ver más información.
Click en "Reembolsar transaccion"
Aparece un modal con dos opciones: Completo (monto total pre-seleccionado) o Parcial (puedes especificar cualquier monto hasta el total original). También puedes añadir un mensaje opcional para el cliente (máximo 50 caracteres).
Confirma el reembolso
Click en Confirmar reembolso. El sistema verifica primero el estado en Evertec, luego procesa el reembolso. El cliente recibe el dinero de vuelta en su app ATH Móvil.
Si al hacer pruebas pagas una factura desde tu propia cuenta ATH Móvil personal hacia tu negocio ATH Business — especialmente si ambos usan el mismo número de teléfono — el pago se procesará correctamente pero el reembolso posterior fallará con BTRA_0005. Evertec bloquea los reembolsos de transacciones de self-payment por seguridad. Para probar el flujo completo (pago + reembolso), pide a un familiar o cliente que pague desde su propio ATH Móvil con su número de teléfono.
Antes de cada reembolso, el sistema consulta a Evertec el estado real de la transacción. Si detecta que ya fue reembolsada parcialmente, te avisa cuánto queda disponible. Todos los intentos quedan registrados en el log de eventos con el JSON de diagnóstico completo.
Comisiones de ATH Móvil
ATH Business cobra una comisión por transacción procesada. No hay mensualidad ni cargo de instalación. Las tarifas exactas dependen de tu acuerdo con Evertec — consulta tu contrato o llama al 787-773-5466 para confirmar tus tarifas.
Los fondos se depositan a la tarjeta ATH registrada en tu cuenta ATH Business. Los pagos están disponibles en tu cuenta bancaria en cuestión de horas, no de días.
Tenants y multi-negocio
Si tienes varios negocios o sucursales, cada tenant en GlobalSuite PR puede tener su propia cuenta ATH Business con su propio pATH y sus propios tokens. Las transacciones se procesan independientemente — los pagos de cada tenant van directamente al pATH correspondiente, no se mezclan.
Errores comunes
| Código | Significado | Solución |
|---|---|---|
| BCUS_0092 | ATH Business unavailable | Tu cuenta no tiene la API REST habilitada. Contacta Evertec al 787-773-5466. |
| BTRA_0005 | Status error en reembolso | Dos causas posibles: (1) La transacción fue un self-payment — el pagador usó la misma cuenta ATH que el negocio. Evertec no permite reembolsos en este caso. Prueba con un pagador externo. (2) La cuenta ATH Business no tiene el servicio de reembolso vía API habilitado — llama a Evertec al 787-773-5466 para solicitarlo. |
| BTRA_0030 | Refund failed — tokens inválidos | El Public Token o Private Token no son válidos. Ve a Settings → Payment Gateways → ATH Móvil y verifica que los tokens estén correctamente guardados. Si los regeneraste recientemente en ATH Business, actualízalos aquí también. |
| Pago expirado | Cliente no autorizó en el tiempo límite | El cliente puede iniciar el pago de nuevo desde la factura. El tiempo de expiración por defecto es 10 minutos. |
| No suena la app | Push notifications no llegan al cliente | El cliente debe revisar permisos de notificaciones en su app ATH Móvil (Settings → Notifications). También puede abrir la app manualmente para ver la solicitud de pago pendiente. |
Si experimentas un error que no está en esta tabla, el log de eventos de cada transacción incluye el JSON completo de respuesta de Evertec — incluyendo el código de error exacto, los dos formatos de referenceNumber que se intentaron, y la duración de cada llamada al API. Puedes descargarlo como .txt desde el detalle de la transacción para enviarlo a soporte.