Qué se descuenta: la comisión del banco
En la segunda fase el dinero se mueve hasta tu cuenta, y lo que llega no es exactamente lo que pagó tu cliente. Aquí está la diferencia: cuándo se aplica la comisión del banco y qué desglose recibes.
Es del banco, no de la plataforma. SPIDI no añade un cargo propio encima: no hay costo de implementación, ni licencias, ni mantenimiento mensual.
Cuándo se aplica
En la acreditación (fase 2), no en el débito. Y el orden importa porque explica por qué:
- Débito (fase 1): tu cliente paga el monto completo. Los fondos se aseguran en una sola transacción y la sesión llega a
paid. Todavía no se ha descontado nada. - Acreditación (fase 2): solo después de tener los fondos se descuenta la comisión, y el resto se acredita —a tu cuenta, o repartido entre las partes del acuerdo—. Llega
payment_session.accredited.
Por eso el monto que ves en la sesión y el que entra en tu cuenta no son el mismo número, y no es un error de cuadre: es que uno es de la fase 1 y el otro de la fase 2.
Liquidación en bolívares
SPIDI liquida en bolívares (Bs) a tu cuenta según tu acuerdo, sin importar cómo pagó tu cliente — cuenta bancaria, Pago Móvil o cripto. El custodio de los fondos entre las dos fases es el Banco Sofitasa.
Qué desglose ves por cada acreditación
Cuando el dinero se acredita, lo que recibes no es una cifra suelta: es un desglose con cinco piezas, y conviene saber qué hace cada una porque son las que necesitas para conciliar.
| Pieza | Para qué te sirve |
|---|---|
| Monto bruto | Lo que pagó tu cliente |
| Comisión del banco | Lo que se descuenta de ese bruto |
| Monto acreditado | Lo que de verdad entra en tu cuenta — es el que va a tu contabilidad |
| Referencia bancaria | El número con el que casas la línea de tu extracto. Es bank_reference_id, y viene compuesto — <referencia>|<comisión>; para el banco solo vale la izquierda → Conciliar contra tu estado de cuenta |
| Banco | A qué cuenta se acreditó |
En un split se aplica POR CRÉDITO
No se descuenta una comisión sobre el total de la sesión para repartir el resto: cada receptor la paga sobre su propia parte, y tú sobre la que te queda a ti.
Así que si repartes una sesión entre tres, verás tres desgloses, cada uno con su bank_commissions_ves. El receiver_credits_summary trae los totales sumados, y su total_credits cuenta a los partners más el owner.
total_credits debe coincidir con los receptores que pediste más uno. Si no cuadra, no concilies con esa respuesta: el dinero puede haberse movido igual, y una contabilidad incompleta lleva a pagar dos veces.
La comisión del banco y el reparto son dos cosas distintas y no conviene mezclarlas ni en el vocabulario ni en la contabilidad.
La comisión del banco es lo que descuenta el banco por procesar la transacción. Lo que se reparte son cuotapartes: la participación que cada parte tiene en esa venta, acordada entre ustedes. La tuya y la de cada partner se llaman igual, porque las dos son eso mismo.
El porcentaje no está en la API
La forma del desglose es estable; los números del ejemplo no. El porcentaje lo fija el banco, y varía en el tiempo y por acuerdo comercial.
Es parte de tu contratación, no un valor de la API. Aquí verás 1 % en los ejemplos y en el simulador: es una cifra redonda para que las cuentas del ejemplo cuadren y puedas comprobar que tu código lee bien cada campo — no la que se te va a aplicar.
Usa el desglose para validar tu integración, nunca para calcular lo que vas a recibir.
Verlo en el simulador
El simulador aplica ese porcentaje ilustrativo al acreditar, para que el desglose cuadre y puedas comprobar que tu código lee bien receiver_credits_summary. Al forzar la fase 2, el webhook payment_session.accredited refleja lo aplicado:
curl -X POST https://sim-productos.abiertolab.com/control/sessions/<id>/outcome \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"leg":2,"outcome":"accredited"}'
# -> webhook payment_session.accredited (con la comisión del banco aplicada)