Saltar al contenido principal
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.

​
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.

​
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.

​
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 Actualizar incorporacion — 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.