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

# Flujos fiat para clientes

> Use la identidad de un cliente existente para retiros fiat, órdenes de pago fiat y cuentas virtuales. El cliente debe estar activo y pertenecer a la empresa autenticada. Omitir customerId conserva el flujo de la empresa; la incorporación del cliente no habilita una integración empresarial ausente.

Use la identidad de un cliente existente para retiros fiat, órdenes de pago fiat y cuentas virtuales. El cliente debe estar activo y pertenecer a la empresa autenticada. Omitir customerId conserva el flujo de la empresa; la incorporación del cliente no habilita una integración empresarial ausente.

## Identidad del cliente y sesiones

Inicie los retiros con customerId en rates y los depósitos con customerId en la cotización. Envíe sessionId en las solicitudes siguientes; el servidor hereda el cliente. Si repite customerId, debe coincidir. Para cambiar el cliente, la ruta, la red o los datos de enrutamiento, solicite una sesión nueva. El descubrimiento de activos, monedas y canales de depósito no acepta customerId.

## Retirar fiat

Rates, métodos de pago, requisitos, resolución, cotización y ejecución aceptan customerId opcional. Las cotizaciones y ejecuciones desde direcciones secundarias también lo aceptan. Los retiros v1 heredados lo aceptan cuando su DTO incluye el contexto del cliente. Noah e Infinia admiten actualmente la identidad del cliente; la API no la sustituye por la identidad empresarial.

```http theme={null}
GET /v2/wallets/{walletId}/withdraw/fiat/rates?assetId={assetId}&currency=USD&amount=100&amountSide=target&customerId={customerId}
```

## Resolución del método de pago

Si la resolución devuelve status: requires\_action, muestre nextStep.schema y envíe continuation con resolutionId, stepId y data a la misma operación. Conserve el paymentMethodData original. Continúe hasta resolved y envíe la respuesta completa como resolvedPaymentMethod al cotizar y ejecutar. Las respuestas heredadas sin status ni nextStep ya están resueltas.

```json theme={null}
{
  "sessionId": "13a36c1c-f4a6-4e49-a582-2ecded2559bc",
  "paymentMethod": "provider-method-id",
  "paymentMethodData": {
    "AccountNumber": "0123456789"
  },
  "continuation": {
    "resolutionId": "provider-resolution-id",
    "stepId": "provider-next-step-id",
    "data": {
      "Acknowledgements": {
        "CoBName": true
      }
    }
  }
}
```

## Recuperación de la incorporación

Los fallos de elegibilidad son errores HTTP, no respuestas data exitosas. Revise details.code, details.customerId, details.provider y details.onboarding.action. Siga el método, la ruta y el cuerpo devueltos. Con create\_case use el cliente existente; con resume\_case consulte el caso; con wait espere; con contact\_support contacte con soporte. No cree otro cliente ni otro caso automáticamente para un caso pendiente o rechazado.

| HTTP | details.code | Acción |
| - | - | - |
| 400 | `CUSTOMER_ONBOARDING_REQUIRED` | Complete o reanude la incorporación. |
| 409 | `CUSTOMER_ONBOARDING_PENDING` | Espere o reanude un paso del cliente. |
| 403 | `CUSTOMER_ONBOARDING_REJECTED` | Muestre el rechazo; no cree otro caso automáticamente. |
| 409 | `CUSTOMER_PROVIDER_UNAVAILABLE` | La relación cliente/proveedor no está disponible; siga la acción devuelta. |

## Depositar fiat

La cotización, la resolución de requisitos y la creación de órdenes aceptan customerId. Con sessionId se heredan assetId, currency, amount y rail; sin sesión son obligatorios. customer contiene datos de contacto opcionales del pagador y no sustituye a customerId. Para KYC integrado, use additionalDataRequirements.data como valores iniciales y valide con el esquema actual antes de enviar additionalData. La incorporación alojada se comprueba por separado.

## Cuentas virtuales

Los requisitos, la creación y la regeneración v2 ya aceptan customerId, incluso al crear o regenerar para direcciones secundarias. Los requisitos validan la pertenencia del cliente y la elegibilidad del proveedor. Use additionalDataSchema; no reutilice esquemas de órdenes de pago. La creación devuelve 201 con created: true para una cuenta nueva, o 200 con created: false si reutiliza una existente.

## Importes y comisiones

debitAmount es el débito total autorizado en el activo de origen. amountFiat es el pago fiat antes de deductions; réstelas una vez para obtener el importe del beneficiario. transactionFee está en el criptoactivo de origen y puede incluir cobros adicionales independientes, la comisión total configurada del método y gastos de procesamiento. No siempre representa toda la comisión: los costes ya cobrados por el proveedor pueden estar incluidos en la financiación y el diferencial está incorporado al tipo. No sume las comisiones a debitAmount. No existe transactionFeeCurrency.

## Véase también

[Webhooks de incorporacion de clientes](https://docs.blockradar.co/es/api-reference/customer-onboarding/webhooks.md)

[Actualizar incorporacion](https://docs.blockradar.co/es/api-reference/customer-onboarding/refresh-request.md) — Solicite nuevas tasas de retiro o una nueva cotización de depósito para crear una sesión fiat nueva. No reutilice una sesión anterior a la aprobación. Los cambios también pueden emitir webhooks customer.onboarding.\*; un caso sin cambios no garantiza un evento nuevo.

## Operaciones del cliente

Se requieren los ID del cliente y del caso. El caso actualizado está en data.case.

* [Actualizar solicitud](https://docs.blockradar.co/es/api-reference/customer-onboarding/update-request.md)
* [Marcar paso alojado enviado](https://docs.blockradar.co/es/api-reference/customer-onboarding/hosted-session-submission.md)
* [Reabrir solicitud](https://docs.blockradar.co/es/api-reference/customer-onboarding/reopen-request.md)
* [Ver documentos](https://docs.blockradar.co/es/api-reference/customer-onboarding/document-view-urls.md)
* [Enviar acción](https://docs.blockradar.co/es/api-reference/customer-onboarding/submit-action.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.