Enviar una transferencia
Mueve dinero de una cuenta tuya a otra cuenta. El destination decide el caso:
- Interna (
type: "account"): entre cuentas de TU tenant. Síncrona. - Entre tenants (
type: "platform_account"): hacia una cuenta de OTRO tenant. Lleva SIEMPRE eltenantdestino, más elalias(que solo identifica junto con su tenant) o elaccount_id. Liquida entre libros; la tarifa de tu acuerdo va enfee— cotízala antes con/v1/quotes.
amount es lo que RECIBE el destino; el origen debita amount + fee.
Una cuenta que exige doble firma responde 202 (pending_approval); la
aprobación la da otro miembro de la cuenta en su app de Tikin — no hay
endpoint de aprobación en este API, y el desenlace llega por webhook
(transfer.completed / transfer.rejected) o por el GET.
Authorization
tenantToken Tu token de tenant: tk_live_…. El entorno sandbox llega pronto; los tokens tk_test_ quedarán reservados para él. Scopes: read, lookup, transfers, bonuses, payouts, webhooks. Usa el mínimo.
In: header
Header Parameters
UUID tuyo. Reintentar con la misma llave es el MISMO pedido (200 en vez de 201, y la respuesta trae el header Idempotent-Replay: true para que tu observabilidad distinga el replay del original); la misma llave con otro cuerpo — bytes de archivos incluidos — es 409.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/transfers" \ -H "Idempotency-Key: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -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": "almuerzo" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "scope": "internal", "status": "completed", "source_account": "0b96a69a-83bf-4bb3-9b52-1bfb05c01fa0", "destination": { "type": "account", "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65" }, "amount": { "raw": "string", "asset": "COPM" }, "fee": { "raw": "string", "asset": "COPM" }, "description": "string", "created_at": "2019-08-24T14:15:22Z"}