Tikin · Docs
API ReferenceMoneyPayouts

Retiro bancario de versiones instaladas

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

Alias conservado del producto. Requiere sesión, PIN, Account y Tenant. amount es bruto en pesos COP; el motor recibe su neto y la comisión. El destino se valida contra la agenda de la cuenta. La misma cuenta e Idempotency-Key conservan el UUID de operación anterior al retiro de Java.

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

Tikin-Version?string

La versión del contrato a la que anclas este pedido, como fecha YYYY-MM-DD. Rige la última publicada en o antes de esa fecha; sin el header, la más reciente.

Formatdate
Idempotency-Key*string

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.

Formatuuid
Tenant*string

Obligatorio en la variante del producto.

Value in

  • "tikin"
  • "beu"
Account*string

Obligatorio en la variante del producto.

Formatuuid
Pin*string

Obligatorio en la variante del producto.

Match^\d{4,8}$

Request 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

curl -X POST "https://example.com/wallet-service/transactions/tikin/withdraw" \  -H "Idempotency-Key: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Tenant: tikin" \  -H "Account: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Pin: string" \  -H "Content-Type: application/json" \  -d '{    "wallet_id": "d9a8fbfc-848f-43a2-9168-911ed3a04a48",    "currency": "COP",    "amount": 1,    "payment_destination": "5feb8b5e-23ef-4075-8fdf-1dcc9f3c39ae"  }'
{  "statusCode": 200,  "message": "Funds withdrawn from wallet",  "id_transaction": "424031c8-b7fd-4c3f-bd23-3b2278e8dad4"}