SINPE operations
Sending and receiving transfers via PIN, DTR and SINPE Móvil, with account validation by IBAN and wallet validation by phone number.
Our banking API lets you build and ship your own financial products, backed by the experience, strength and security of a direct SINPE participant.
// Transferir a una cuenta SINPE
POST transactions/payments
{
"payment_method_code": "PIN",
"direction": "OUT",
"country_code": "CR",
"amount": { "amount": "1000.00", "currency": "CRC" },
"source": {
…{
"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"
}
}A transactional platform that centrally manages the full lifecycle of financial operations: from receiving the instruction to executing and confirming it.
Sending and receiving transfers via PIN, DTR and SINPE Móvil, with account validation by IBAN and wallet validation by phone number.
Query single transactions or lists, check Tilopay account balances and get notified of transfer status changes.
Deposit validation against purchase orders, automatic rejection of unmatched deposits, instant verification and notification by API and webhook.
Issuing digital and physical VISA or Mastercard cards linked to IBAN accounts and to the funds available in each account.
An extensive REST API that centralizes transactional logic, controls the lifecycle of each operation and guarantees accounting consistency with end-to-end traceability.
See the full banking API reference// Validar una cuenta SINPE
POST accounts/validate
{
"payment_method_code": "PIN",
"account": {
"type": "IBAN",
"value": "CR12015201001012345678"
}
}{
"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
}
}Documentation
Authentication, envelope conventions, the response-code catalog, payment, account, webhook and catalog operations, plus the downloadable OpenAPI 3.0.3 spec.
Open the banking API documentationTilopay's MCP server includes eleven read tools over the banking API. None of them initiates, approves or reverses transfers: they only extract information.
They are enabled on request and only work for users with Tilopay banking API credentials.
baas_list_accountsAccounts accessible to the token, with or without balances.
baas_list_balancesBalance of every account in the context in a single call.
baas_list_paymentsMovements by account and date range, with pagination.
baas_search_paymentBy payment_id, public_id or client reference.
baas_request_statementGenerates a read-only statement; it moves no money.
baas_analyze_paymentsAnalytical report on the period's payments.
A distributed platform designed to run at multinational scale with high resilience and data isolation.
A multi-tenant structure that separates operating contexts and allows internal authorization per context, with external authentication (CIAM).
Decouples the account core from transaction execution and guarantees accounting consistency with end-to-end traceability.
A throughput- and low-latency-oriented stack to manage the full lifecycle of each transaction.
A distributed GCP platform with multi-zone architecture, active redundancy and continuous monitoring.
Active certification, with Attestation of Compliance and Report on Validation available.
TLS 1.2 or higher in transit; tokenization and AES-256 encryption for stored data.
An extensive, flexible API to integrate directly with your collection flows and internal systems.
Tell us your volume and use case and we will share the commercial structure, the setup schedule and technical access.
Contact sales