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

Inicie el retiro solicitando tasas e incluya customerId solo si el pago pertenece a un cliente. Los pasos posteriores heredan el cliente de sessionId. Cambiar de cliente requiere otra sesión. La integración de la empresa debe seguir siendo elegible.

Resolución del método de pago

Cuando status sea requires_action, muestra nextStep.schema y envía una continuation con el resolutionId devuelto, nextStep.id como stepId y los datos solicitados. Repite hasta que status sea resolved. Para los métodos que guardan la resolución completada en la sesión de retiro, el backend conserva el formulario y la resolución más recientes de cada método de pago. Cotizar y ejecutar solo requieren sessionId y paymentMethod; no vuelvas a enviar el formulario ni la resolución. Resuelve de nuevo si cambian los datos del beneficiario. Completar la resolución no sustituye la cotización: solicita y revisa una antes de ejecutar.

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.