Pagos

Comisiones

Las dos comisiones de cada depósito, sobre qué base se calculan y cómo queda el reparto.

Cada depósito se reparte en la misma transacción que lo mueve. Hay dos comisiones, independientes entre sí, expresadas en puntos básicos (100 = 1 %).

Concepto	Campo	Quién lo fija	A dónde va
ConceptoComisión de la plataforma	Campo`platform_fee_bps`	Quién lo fijaLa plataforma	A dónde vaBilletera de la plataforma
ConceptoComisión de la empresa a su usuario	Campo`merchant_fee_bps`	Quién lo fijaLa empresa (o la plataforma desde el panel)	A dónde vaBilletera de comisiones de la empresa (`fee_wallet`); si no tiene, su tesorería
ConceptoBase de la comisión de la empresa	Campo`merchant_fee_base`	Quién lo fijaIgual que la anterior	A dónde va`gross`: se calcula sobre el depósito completo · `net`: sobre lo que queda después de la comisión de la plataforma
ConceptoGas del barrido	Campo`gas_mode`	Quién lo fijaLa plataforma	A dónde vaVer Gas
ConceptoEl resto	Campo—	Quién lo fija—	A dónde vaTesorería de la empresa (`treasury`)

Ejemplos: 100 USDT con 1 % de plataforma#

Comisión de la empresa	Base	Gas	Plataforma	Comisión empresa	Tesorería
Comisión de la empresa0 %	Base—	GasLo paga la plataforma	Plataforma1	Comisión empresa0	Tesorería99
Comisión de la empresa2 %	Base`gross`	GasLo paga la plataforma	Plataforma1	Comisión empresa2	Tesorería97
Comisión de la empresa2 %	Base`net`	GasLo paga la plataforma	Plataforma1	Comisión empresa1.98	Tesorería97.02
Comisión de la empresa2 %	Base`gross`	Gas0.10, lo paga la empresa	Plataforma1 + 0.10 de gas	Comisión empresa2	Tesorería96.90

La comisión de la empresa es dinero de la empresa: en los ejemplos, entre la tesorería y la billetera de comisiones la empresa recibe 99 (o 98.90 si paga el gas). Separarla sirve para distinguir, en la propia blockchain, lo que es recarga del usuario de lo que es ingreso por comisión.

Fórmula#

Reparto

comisión_plataforma = ⌊ monto × platform_fee_bps / 10000 ⌋

base                = monto                         si merchant_fee_base = gross
                    = monto − comisión_plataforma   si merchant_fee_base = net

comisión_empresa    = ⌊ base × merchant_fee_bps / 10000 ⌋

neto                = monto − comisión_plataforma − comisión_empresa − gas

Todo se calcula en enteros, en la unidad mínima del token, redondeando cada comisión hacia abajo. Es la misma cuenta en el servidor y en el contrato, así que el reparto cotizado y el que ocurre en la blockchain coinciden al céntimo.

Sin tope#

Las comisiones no tienen un máximo propio: cada una puede ir de 0 a 10000 puntos básicos (0 a 100 %). La única regla es que juntas no se lleven más que el depósito.

Con base gross, si platform_fee_bps + merchant_fee_bps supera 10000, la API responde 400 con Las comisiones de la plataforma y de la empresa suman más del 100 % del depósito.
Con base net la suma siempre cabe, porque la segunda comisión se calcula sobre lo que dejó la primera.
Si las comisiones más el gas superan un depósito concreto, ese depósito queda como below_minimum y el contrato no lo barre.

Cambiar tu comisión#

cURL

1curl -X PATCH https://api.pasarela.hi-g.io/v1/me \2  -H "x-api-key: sk_test_4f9c…" \3  -H "content-type: application/json" \4  -d '{"merchant_fee_bps": 200, "merchant_fee_base": "net"}'

El cambio se escribe en el contrato (tarda unos segundos) y vale para los barridos que ocurran después. Para ver cómo quedaría un depósito con las condiciones actuales, usa Cotizaciones.