API Bancario de Tilopay

Disponible únicamente en Costa Rica.

Además de la pasarela de pagos, Tilopay opera un API bancario independiente: una plataforma de Banking-as-a-Service que expone operaciones SINPE, cuentas IBAN y gestión de recaudos.

Es un producto separado. Corre en su propia infraestructura, con credenciales y autenticación propias. Un comercio que ya integra el API de pagos de Tilopay no obtiene acceso a este automáticamente, y las dos integraciones no comparten nada más que la marca.

Qué permite hacer#

Transferencias SINPE. Envío y recepción de transferencias por PIN, DTR y SINPE Móvil, con consulta del estado de cada movimiento.

Validación de cuentas destino. Verificar una cuenta antes de transferir, por IBAN o por número de teléfono, y recibir el nombre del titular y la entidad financiera. Sirve para confirmarle al usuario a quién le está pagando antes de mover el dinero.

Cuentas IBAN. Consulta de saldos —disponible, contabilizado y montos en tránsito— y de movimientos, individualmente o por lote, con filtros por fecha, estado, moneda y referencia propia.

Gestión de recaudos. Validación de depósitos contra órdenes de compra, con rechazo automático de los depósitos que no correspondan a ninguna, y verificación en tiempo real.

Emisión de tarjetas. Tarjetas VISA o Mastercard, digitales y físicas, asociadas a cuentas IBAN y a los fondos disponibles.

Notificaciones. Webhooks para cambios de estado de las transferencias, configurables por evento y firmados.

Entornos#

El API bancario cuenta con un entorno de pruebas separado del de producción, con hosts distintos. Las credenciales de cada entorno se entregan al momento de habilitar el acceso.

Cómo obtener acceso y documentación#

El acceso es restringido, se otorga por solicitud y está disponible solo para operaciones en Costa Rica.

Para conocer el producto y solicitar acceso comercial: baas.tilopay.com, indicando volumen mensual estimado, caso de uso y sistemas a integrar.

Para la documentación técnica detallada —operaciones, parámetros, formatos de respuesta y contratos de webhook— escribí a soporte@tilopay.com. Se entrega junto con las credenciales al habilitar el acceso.