Tikin · Docs
API ReferenceMoneyHistorial del producto

Transferir entre cuentas desde el producto

POST
/wallet-service/transactions/{tenant}/transfer

Exige sesión, cuenta propia, PIN e Idempotency-Key. MOTOR_LIBRO_ENABLED controla la disponibilidad del contrato instalado por entorno; apagado devuelve 404. Valida destino distinto, bolsillo origen propio si se suministra y pertenencia al tenant del libro. Conserva el lexema decimal de amount antes de convertirlo a unidades enteras, incluidos valores superiores a la precisión de IEEE-754; no redondea fracciones de unidad. El principal llega al bolsillo main del destinatario. La identidad del actor se deriva de Auth, no de headers aportados por el cliente. Un reintento debe conservar la misma llave y el mismo cuerpo; un 503 no confirma ni descarta la operación.

Authorization

productSession
AuthorizationBearer <token>

Sesión del usuario del producto Tikin, con headers Tenant y Account; distinta del token de tenant de plataforma.

In: header

Path Parameters

tenant*string

Value in

  • "tikin"
  • "beu"

Header Parameters

Tenant*string

Value in

  • "tikin"
  • "beu"
Account*string
Formatuuid
Pin*string
Idempotency-Key*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/wallet-service/transactions/tikin/transfer" \  -H "Tenant: tikin" \  -H "Account: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Pin: string" \  -H "Idempotency-Key: string" \  -H "Content-Type: application/json" \  -d '{    "account_id_to": "9add39aa-637d-4ce6-b95b-e136cdb14023",    "amount": 1  }'
{  "message": "Funds transferred successfully",  "id_transaction": "424031c8-b7fd-4c3f-bd23-3b2278e8dad4"}