El API de Tikin
El sistema operativo financiero de cómo América Latina gana, paga y construye — cuentas, transferencias y payouts sobre un libro de partida doble.
El sistema operativo financiero de LATAM
Tikin es el sistema operativo financiero de cómo América Latina gana, paga y construye. El dinero entra. El dinero vive aquí. El dinero sigue trabajando. Y debajo de todo hay tres cosas: la relación con cada persona, el libro que no miente, y la experiencia de moverlo con unas cuantas líneas.
El API se organiza como la plataforma — cinco dominios, cada uno con su promesa:
| Dominio | La promesa | Qué vive ahí |
|---|---|---|
| Identity | Quién es quién | profile · sessions · memberships |
| Accounts | Toda relación empieza en una cuenta | cuentas · compliance |
| Money | El corazón: el libro que no miente | ledger · transfers · payouts · quotes |
| Platform | El plano de tu tenant | tenant · assets · FX · webhooks |
| Services | Lo que se construye encima | bonuses · investments |
Mueve dinero como si fuera código
Con este API tu empresa abre cuentas, mueve dinero entre ellas al instante, paga a cientos de personas de una vez y lo saca al mundo — a una cuenta bancaria o en efectivo.
Debajo de cada request hay un libro contable de partida doble: cada peso que se mueve deja dos asientos que tienen que cuadrar, ningún asiento se edita jamás, y la respuesta que recibes es la verdad del libro — no una promesa. Es la misma contabilidad que lleva un banco, expuesta como un API que se integra en una tarde.
Empieza por tu primer request, o directo a la referencia.
| Entorno | URL base | Token |
|---|---|---|
| Producción | https://api.tikin.is | tk_live_… — mueve dinero real |
El entorno sandbox llega pronto; los tokens
tk_test_quedarán reservados para él.
Los tres principios
1. Los montos son texto. Siempre enteros en unidades mínimas del asset, como
string: { "raw": "2500000", "asset": "COPM" } son $25.000 COP. Nunca números
flotantes — JSON los corrompe y el dinero ajeno no se redondea.
Dinero →
2. Todo lo que mueve dinero exige Idempotency-Key. Reintentar con la misma
llave es el MISMO pedido: recibes la operación original (200), no una nueva. La
misma llave con otro cuerpo es 409.
Idempotencia →
3. Los errores hablan. Cada error trae un code de máquina, un message
humano y un doc_url. Un 422 significa "la regla de negocio dijo no" — y el
detalle dice cuál regla y con qué números.
Errores →
Por dónde empezar
- Primeros pasos — tu primer request:
resolver un destinatario y enviarle dinero, en dos
curl. - El mapa de dominios — cómo se organiza el API y por qué.
- Webhooks — que te avisemos, con firma, cuando algo pase.
- API Reference — cada endpoint, con playground para probarlo aquí mismo.
- Descarga el OpenAPI — el spec completo, para generar tu cliente en el lenguaje que uses.
Lo que este API no finge
Nada es instantáneo por decreto. Las operaciones asíncronas (payouts, lotes de
bonos) devuelven un recurso con status y se siguen por polling o webhooks. Y si
el libro no contesta, la respuesta es 503 — jamás un éxito inventado ni un cero
falso.