Primeros pasos

Lo que necesitas

Tu token de tenant (tk_live_…). Todo lo de esta guía corre contra https://api.tikin.is — dinero real, así que usa montos chicos mientras pruebas. (El entorno sandbox llega pronto; los tokens tk_test_ quedarán reservados para él.)

1. Resolver el destinatario

Antes de enviar, confirma a QUIÉN. El lookup resuelve un alias ($tag) o un teléfono a lo mínimo para confirmar, sin datos sensibles:

curl "https://api.tikin.is/v1/accounts/lookup?alias=%24bottico" \
  -H "Authorization: Bearer tk_live_…"

{
  "account_id": "b937b865-32ad-44a5-a654-067154480465",
  "alias": "$bottico",
  "display_name": "Angel B.",
  "type": "person"
}

Muéstrale ese display_name a tu usuario. Si no existe → 404.

2. Enviar la transferencia

Con el account_id del paso 1, genera un UUID como Idempotency-Key y envía:

curl -X POST https://api.tikin.is/v1/transfers \
  -H "Authorization: Bearer tk_live_…" \
  -H "Idempotency-Key: $(uuidgen | tr 'A-Z' 'a-z')" \
  -H "Content-Type: application/json" \
  -d '{
    "source_account": "7b0d0f52-3f3e-4bf0-9d5a-111111111111",
    "destination": { "type": "account", "account_id": "b937b865-32ad-44a5-a654-067154480465" },
    "amount": { "raw": "2500000", "asset": "COPM" },
    "description": "primer envío"
  }'

amount.raw es texto en centavos: "2500000" = $25.000. Por qué →

201 — se movió:

{
  "id": "0d9a…",
  "scope": "internal",
  "status": "completed",
  "amount": { "raw": "2500000", "asset": "COPM" },
  "created_at": "2026-09-08T15:04:05Z"
}

Otros desenlaces que vas a ver: 200 (replay de tu misma llave — no salió dinero dos veces), 202 (la cuenta exige aprobación de otro miembro; queda pending_approval), 422 (la regla dijo no — insufficient_funds, capability_cannot_send… la tabla).

3. Verificar

curl https://api.tikin.is/v1/accounts/7b0d0f52-…/balances \
  -H "Authorization: Bearer tk_live_…"

El saldo available bajó. Eso es todo el ciclo: lookup → transfer → balance. Desde aquí: webhooks para enterarte sin preguntar, o el playground para probar cada endpoint desde el navegador.