> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onepay.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Billetera a billetera

> Enviar dinero a otra billetera.

### Headers

<ParamField header="x-idempotency" type="string" required placeholder="Token único para garantizar la idempotencia de la petición">
  Token único para garantizar la idempotencia de la petición
</ParamField>

### Body

<ParamField type="string" body="origin" required placeholder="Wallet ID de la billetera que enviará el dinero">
  Wallet ID de la billetera que enviará el dinero
</ParamField>

<ParamField type="string" body="destination" required placeholder="Wallet ID de la billetera que recibirá el dinero">
  Wallet ID de la billetera que recibirá el dinero
</ParamField>

<ParamField type="string" body="amount" required placeholder="Monto a enviar">
  Monto a enviar
</ParamField>

<ParamField type="string" body="concept" placeholder="Descripción de la transacción">
  Descripción de la transacción
</ParamField>

<ParamField type="string" body="external_id" placeholder="ref-001">
  Identificador externo opcional (máx. 255 caracteres). Si lo envías, se guarda en la transacción y se devuelve tal cual en el webhook `wallet.transaction.created`, lo que te permite correlacionar la transferencia con tus registros internos.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "0194b9a9-45e4-73c5-8139-44d3813d8f29",
    "type": "withdraw",
    "amount": -1000,
    "label": "$1.000",
    "concept": "Prueba",
    "subtype": "WALLET_TRANSFER",
    "confirmed": true,
    "node_type": null,
    "created_at": "2025-01-31",
    "external_id": "ref-001",
    "node": null
  }
  ```

  ```json 401 theme={null}
  {
    "message": "No tienes fondos suficientes para hacer está operación, necesitas depositar fondos para continuar.",
    "code": 10501,
    "code_name": "insufficient_funds"
  }
  ```

  ```json 404 theme={null}
  {
    "message": "Registro no encontrado, Cliente no existe",
    "code": 10002,
    "code_name": "record_not_found"
  }
  ```

  ```json 409 theme={null}
  {
    "message": "No se puede generar la operación, genera un token de idempotencia y envíelo en los headers como x-idempotency",
    "code": 10003,
    "code_name": "idempotency_error"
  }
  ```
</ResponseExample>