Participante SINPE directo · Código 369 (PSP)

Banking-as-a-Service para construir soluciones financieras en Costa Rica

Nuestra API bancaria te permite desarrollar e implementar productos financieros propios, aprovechando la experiencia, solidez y seguridad de un participante directo del SINPE.

SINPE transferenciasIBAN cuentas propiasConciliación automáticaSINPE MóvilEmisión de tarjetas

Contactar Ver servicios por API

PCI DSS Nivel 199.99% de disponibilidadProveedor de Servicios de Pago

POST transactions/payments

// Transferir a una cuenta SINPE
POST transactions/payments

{
  "payment_method_code": "PIN",
  "direction": "OUT",
  "country_code": "CR",
  "amount": { "amount": "1000.00", "currency": "CRC" },
  "source": {
…

Respuesta

{
  "success": true,
  "http_status_code": 201,
  "response_code": "CREATED",
  "message": "The resource was created successfully.",
  "correlation_id": "b35b8e71-c0b4-4525-8e34-d6eb9d319243",
  "data": {
    "created_at": "2026-08-10T17:24:11Z",
    "payment_id": "bd6f2181-aeed-4ec3-b63e-652976b6da12",
    "payment_method_code": "PIN",
    "public_id": "2951",
    "status": "pending",
    "status_detail": "PROCESSING"
  }
}

201 CREATED

En vivohace 2s

Transferencia recibida

₡150.000

Conciliada automáticamente

Servicios disponibles por API

Una plataforma transaccional que gestiona de forma centralizada el ciclo completo de las operaciones financieras: desde la recepción de la instrucción hasta su ejecución y confirmación.

sinpe

Operaciones sobre el SINPE

Envío y recepción de transferencias mediante PIN, DTR y SINPE Móvil, con validación de cuentas por IBAN y de monederos por número de teléfono.

cuentas iban

Operaciones sobre cuenta IBAN

Consulta de transacciones individuales o por listado, saldo de las cuentas de Tilopay y notificación de cambios de estado de las transferencias.

cobros

Gestión de cobros

Validación de depósitos contra órdenes de compra, rechazo automático de depósitos no asociados, verificación inmediata y notificación por API y Webhook.

tarjetas visa · mastercard

Emisión de tarjetas VISA o Mastercard

Emisión de tarjetas digitales y físicas de las marcas VISA o Mastercard asociables a las cuentas IBAN y a los fondos disponibles en cada cuenta.

Diseñado para equipos técnicos, listo para producción

Una API REST extensa que centraliza la lógica transaccional, controla el ciclo de vida de cada operación y garantiza consistencia contable con trazabilidad end-to-end.

Ver la referencia completa del API bancario

POST accounts/validate

// Validar una cuenta SINPE
POST accounts/validate

{
  "payment_method_code": "PIN",
  "account": {
    "type": "IBAN",
    "value": "CR12015201001012345678"
  }
}

Respuesta

{
  "success": true,
  "http_status_code": 200,
  "response_code": "OK",
  "message": "The request was processed successfully.",
  "correlation_id": "d0115c5e-6f10-4ffb-b0f7-8f85ac1724fc",
  "data": {
    "account": {
      "currency": "CRC",
      "product_name": "Cuenta de ahorros",
      "type": "IBAN",
      "value": "CR12015201001012345678"
    },
    "financial_institution": {
      "country_code": "CR",
      "entity_code": "001",
      "entity_name": "Banco Ejemplo"
    },
    "holder": {
      "id_number": "100000001",
      "id_type": "cedula",
      "name": "Jacinto Contreras"
    },
    "is_valid": true
  }
}

200 OK

Documentación

La referencia del API bancario vive en el portal de desarrolladores

Autenticación, convenciones del envelope, catálogo de códigos de respuesta, operaciones de pagos, cuentas, webhooks y catálogos, más el spec OpenAPI 3.0.3 descargable.

Abrir la documentación del API bancario

Agentes de IA

Consultá tus cuentas y movimientos desde un agente de IA

El servidor MCP de Tilopay incluye once herramientas de consulta sobre el API bancario. Ninguna inicia, aprueba ni revierte transferencias: sólo extraen información.

Se activan bajo solicitud y sólo funcionan para usuarios con credenciales del API bancario de Tilopay.

baas_list_accounts

Listar cuentas

Cuentas accesibles según el token, con o sin saldos.

baas_list_balances

Saldos

Saldo de todas las cuentas del contexto en una sola consulta.

baas_list_payments

Pagos

Movimientos por cuenta y rango de fechas, con paginación.

baas_search_payment

Buscar un pago

Por payment_id, public_id o referencia del cliente.

baas_request_statement

Estado de cuenta

Genera un estado de cuenta de consulta, sin mover dinero.

baas_analyze_payments

Análisis de movimientos

Informe analítico sobre los pagos del periodo.

Ver las 11 herramientas bancarias del MCP

Arquitectura Cloud-First

01
Nativa en la nube sobre GCP
Plataforma distribuida, diseñada para operar a escala multinacional con alta resiliencia y aislamiento de datos.
02
Jerarquía País → Tenant → Partner
Estructura multi-tenant que separa contextos operativos y permite autorización interna por contexto, con autenticación externa (CIAM).
03
Gateway de asientos contables
Desacopla el core de cuentas de la ejecución de transacciones y garantiza consistencia contable con trazabilidad end-to-end.
04
Go, PostgreSQL y Redis
Stack orientado a throughput y baja latencia para gestionar el ciclo de vida completo de cada transacción.

Cumplimiento y seguridad

99.99% de disponibilidad

Plataforma distribuida en GCP con arquitectura multi-zona, redundancia activa y monitoreo continuo.

PCI DSS Level 1

Certificación activa, con Declaración de Cumplimiento e Informe de Validación disponibles.

Cifrado y protección de datos

TLS 1.2 o superior en tránsito; tokenización y cifrado AES-256 para los datos almacenados.

Integración full code

API extensa y flexible para integrarse directamente con tus flujos de cobro y sistemas internos.

Preguntas frecuentes

Recordá que podés contactarnos y resolveremos tus dudas

Es la plataforma Banking-as-a-Service de Tilopay: una API REST que expone operaciones SINPE, cuentas IBAN y gestión de cobros para que las empresas integren pagos y transferencias directamente en sus sistemas.

Sí. Tilopay es una entidad participante afiliada al SINPE bajo el código 369 como Proveedor de Servicios de Pago (PSP).

Sí. Tilopay está inscrito ante la Superintendencia General de Entidades Financieras (SUGEF) bajo el artículo 15 desde el año 2021.

Envío y recepción de transferencias mediante PIN, DTR y SINPE Móvil, además de validación de cuentas por IBAN y de monederos por número de teléfono.

Cada depósito se valida contra la orden de compra correspondiente; los depósitos no asociados se rechazan automáticamente y el resultado se notifica por API y Webhook en tiempo real.

99.99% de disponibilidad sobre una arquitectura multi-zona en Google Cloud Platform, con certificación PCI DSS Level 1, TLS 1.2 o superior en tránsito y cifrado AES-256 en reposo.

Escribinos a contacto@tilopay.com o usá el formulario de contacto indicando tu volumen mensual estimado y caso de uso; te compartimos la estructura comercial y el acceso técnico.

Hablemos de tu integración al API bancario

Contanos tu volumen y caso de uso y te compartimos la estructura comercial, el cronograma de configuración y el acceso técnico.

Contactar a ventas