Saltar al contenido principal

Comisiones

Esta página describe las comisiones incluidas en la cotización del pago: lo que envía el pagador además del importe del comercio. No sustituye a los precios de la plataforma alojada (0,5 % de cada transacción en OrcaRail alojado tras 1.000 transacciones gratis; el software autoalojado es gratuito).

OrcaRail puede aplicar hasta tres tipos de comisiones a un pago: comisión de soporte, comisión y comisión de puente. Todas se expresan en el token del pagador y se incluyen en el importe total que el pagador debe enviar. Las respuestas de la cotización (y del payment intent) exponen estos importes e indicadores.

Fórmula del importe total​

El importe que debe enviar el pagador es:

totalAmount = originalAmountInPayerToken + bridgeFeeInPayerToken + supportAmount + commissionAmount
  • originalAmountInPayerToken: el importe solicitado convertido al token del pagador (antes de cualquier comisión).
  • bridgeFeeInPayerToken: comisión de puente/swap cuando el token o la red del pagador difieren del token o la red cobrables (de Relay). null cuando no hace falta puente.
  • supportAmount: comisión de soporte opcional en el token del pagador (ver abajo).
  • commissionAmount: comisión opcional en el token del pagador (ver abajo).

Las respuestas de Obtener cotización y de la cotización del payment intent devuelven estos campos tal como se definen en la API (por ejemplo QuoteResponseDto).

Comisión de soporte​

  • Qué es: un porcentaje opcional del importe original (el importe que recibe el comercio).
  • Valor por defecto: de la variable de entorno PAYMENTS_DEFAULT_SUPPORT_PERCENT. El valor por defecto de la API es 0.5 (0,5 %) si no se define.
  • Sustitución: puedes sustituir el porcentaje de soporte por cotización o por transacción con el parámetro supportPercent (por ejemplo en Obtener cotización o al crear/actualizar una transacción).
  • Suelo mínimo: cuando el porcentaje de soporte es mayor que 0, el importe de soporte calculado se eleva como mínimo al mínimo de la red de esa cadena (para evitar polvo). La cotización incluye supportMinimumApplied: true cuando se aplica este suelo.
  • Destino: la wallet de soporte de OrcaRail (configurable en el servidor).

Comisión de soporte (respuesta de la cotización)​

CampoDescripción
supportPercentPorcentaje de comisión de soporte aplicado (string).
supportAmountImporte de soporte en el token del pagador (string).
supportMinimumAppliedtrue cuando el importe de soporte se elevó al mínimo de la red.

Comisión​

  • Qué es: un porcentaje opcional del importe original, configurado por clave de API (commissionPercent). Solo se aplica cuando el enlace de pago o el payment intent se crea con esa clave de API.
  • Configuración: se define al crear o actualizar una clave de API (en el panel o con la API de claves de API). Si no se define, la comisión es 0.
  • Regla de 0,01 USD: si el importe de la comisión en USD es inferior a 0,01 $, la API pone la comisión a 0 (no se cobra).
  • Suelo mínimo: igual que con el soporte: cuando el porcentaje de comisión es mayor que 0, el importe se eleva al mínimo de la red. La cotización incluye commissionMinimumApplied: true cuando se aplica este suelo.
  • Destino: la dirección de retiro del propietario de la clave de API para la cadena correspondiente (se usa al procesar los retiros).

Comisión (respuesta de la cotización)​

CampoDescripción
commissionPercentPorcentaje de comisión (de la clave de API) aplicado al importe original (string).
commissionAmountImporte de la comisión en el token del pagador (string).
commissionMinimumAppliedtrue cuando el importe de la comisión se elevó al mínimo de la red.

Comisión de puente​

  • Cuándo se aplica: cuando el token o la red del pagador difieren del token o la red cobrables, hace falta un puente o un swap. La comisión de puente es el coste de esa operación.
  • Origen: la comisión se obtiene de Relay y se incluye en la cotización.
  • En el total: la comisión de puente (en el token del pagador) se incluye en totalAmount, para que el pagador envíe lo suficiente para cubrir el puente y el comercio reciba el importe solicitado.

Comisión de puente (respuesta de la cotización)​

CampoDescripción
bridgeFeeComisión de puente/swap si aplica (en el token del pagador); null si no hay puente.
bridgeFeeUsdComisión de puente en USD; null si no hay puente.
bridgeFeeInPayerTokenComisión de puente en el token del pagador; null si no hay puente.
requiresBridgetrue cuando hace falta un puente o un swap.

Consulta también​