# API Bancario de Tilopay

> Plataforma de Banking-as-a-Service de Tilopay, disponible solo en Costa Rica y con acceso restringido.

- kind: guide
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/api-bancario

**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 [#que-permite]

**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 [#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 [#acceso]

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](https://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.