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
Comisión de la plataforma	`platform_fee_bps`	La plataforma	Billetera de la plataforma
Comisión de la empresa a su usuario	`merchant_fee_bps`	La empresa (o la plataforma desde el panel)	Billetera de comisiones de la empresa (`fee_wallet`); si no tiene, su tesorería
Base de la comisión de la empresa	`merchant_fee_base`	Igual que la anterior	`gross`: se calcula sobre el depósito completo · `net`: sobre lo que queda después de la comisión de la plataforma
Gas del barrido	`gas_mode`	La plataforma	Ver Gas
El resto	—	—	Tesorerí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
0 %	—	Lo paga la plataforma	1	0	99
2 %	`gross`	Lo paga la plataforma	1	2	97
2 %	`net`	Lo paga la plataforma	1	1.98	97.02
2 %	`gross`	0.10, lo paga la empresa	1 + 0.10 de gas	2	96.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

1comisión_plataforma = ⌊ monto × platform_fee_bps / 10000 ⌋2 3base                = monto                         si merchant_fee_base = gross4                    = monto − comisión_plataforma   si merchant_fee_base = net5 6comisión_empresa    = ⌊ base × merchant_fee_bps / 10000 ⌋7 8neto                = 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.melenashair.com/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.