Enviar un bono desde el producto
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. La tarifa BONO de la cuenta se consulta en el libro: el emisor paga la comisión con las dos patas tenantFee/platformFee; el destinatario recibe el principal íntegro.
Authorization
productSession Sesión del usuario del producto Tikin, con headers Tenant y Account; distinta del token de tenant de plataforma.
In: header
Path Parameters
Value in
- "tikin"
- "beu"
Header Parameters
Value in
- "tikin"
- "beu"
uuid1 <= lengthRequest 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/bonuses" \ -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"}