#

Cobrar comisión

Si querés quedarte con una parte de cada pago que pasa por tu integración, configurás una comisión y una cuenta que la recibe (el recaudador). A partir de ahí, cada pago que cobra un comercio tuyo se divide solo: el comercio recibe su pago y tu comisión se transfiere a la cuenta del recaudador, sin que tengas que hacer nada por cobro.

#

El mapa mental

  • Oferta = la tasa que publicás como integración. Es una plantilla, no un cobro: por sí sola no mueve un peso.
  • Recaudador = la cuenta de ChytaPay que recibe las comisiones. Es una cuenta real con CVU, NO tu cuenta de admin del Portal (esa configura, no recibe dinero).
  • Comisión aceptada = la foto de la oferta que queda pegada a cada comercio cuando se enrola. Es lo que el motor cobra, y es por comercio.
  • Motor de distribución = corre por cada pago acreditado: calcula el split y lo transfiere al recaudador.
#

Cómo empezar a cobrar: 3 pasos

1
Configurás la comisión de tu integración
Portal → Distribución

En el bloque Comisión escribís el porcentaje en el campo Comisión (%) y tocás Guardar (si ya había una configurada, el botón dice Actualizar; Eliminar la borra). No existe la comisión de 0%: si no querés cobrar, no configurás ninguna.

Si preferís automatizarlo: PUT /my-integration/distribution/offer

2
Invitás al recaudador y esperás que acepte
Portal → Distribución

En el bloque Recaudador escribís la dirección en Email del recaudador y tocás Invitar. Le llega un mail con un link y recién cuando ACEPTA queda activa: hasta ese momento el bloque la muestra como pendiente y podés dar marcha atrás con Cancelar invitación. Con un recaudador ya activo el botón pasa a ser Reemplazar recaudador. Una sola invitación pendiente y un solo recaudador activo por integración.

Si preferís automatizarlo: POST /my-integration/distribution/payout-link/invite

3
Cada comercio acepta la comisión al enrolarse
Pantalla de autorización del flujo OAuth

Cuando el comercio autoriza tu integración, la pantalla le dice textualmente que vas a cobrar esa comisión por cada pago; autorizar ES aceptarla. En ese momento la tasa vigente queda congelada para ese comercio. Después, en Cuentas de comercio, la columna Comisión te muestra qué tasa aceptó cada uno — puede no coincidir con la que tenés configurada hoy.

Listo: desde el primer pago acreditado de un comercio enrolado, la comisión se transfiere sola a la cuenta del recaudador.

Pantalla Distribución del Portal: el campo Comisión (%) arriba y el bloque Recaudador con una cuenta activa abajo.
Portal → Distribución: la comisión arriba, el recaudador abajo. Así se ve cuando ya está cobrando: el recaudador figura como activo.
Los dos primeros pasos son independientes, pero NINGUNO cobra solo. Comisión configurada sin recaudador aceptado = cada pago saltea el split: no cobrás nada y no falla nada. El Portal te avisa con un cartel en Distribución y en Cuentas de comercio; si lo ves, todavía no estás cobrando.
Cómo pegarle por API

Los tres pasos viven en la Integration Admin API. La URL base es {{integration-admin-url}} (la de tu ambiente está en Variables de URLs) y el token es el idToken de admin del Portal, el que devuelve POST /integration/admin/login — NO el token del comercio: ese solo sirve para la Integration API y acá da 401.

curl
# 1) Configurar la comisión de la integración (5% de cada pago)
curl -X PUT {{integration-admin-url}}/my-integration/distribution/offer \
  -H "Authorization: Bearer {admin_id_token}" \
  -d '{ "percentage": 5 }'

# 2) Invitar a la cuenta que va a recibir las comisiones
curl -X POST {{integration-admin-url}}/my-integration/distribution/payout-link/invite \
  -H "Authorization: Bearer {admin_id_token}" \
  -d '{ "email": "[email protected]" }'

# 3) Verificar que el recaudador ya aceptó -> status: "accepted"
curl {{integration-admin-url}}/my-integration/distribution/payout-link \
  -H "Authorization: Bearer {admin_id_token}"
#

Cuándo y cómo se calcula

La comisión se calcula por cada pago acreditado, no por solicitud de cobro ni por lote, y se transfiere en el momento: no hay liquidación diferida ni acumulación a fin de mes.

  • Sobre el bruto — el porcentaje se aplica al monto del pago tal como entró, sin descontar antes ninguna otra comisión.
  • Pagos parciales — si una solicitud de cobro se paga en varias veces, cada pago paga su propia comisión sobre lo que entró.
  • Una sola vez por pago — el motor es idempotente por pago entrante: un reintento interno no vuelve a cobrar.
  • Redondeo — a 2 decimales, en pesos. Un monto fijo nunca puede superar el pago: se recorta al bruto.
  • De dónde sale — se debita de la cuenta del comercio que cobró y se acredita en la cuenta del recaudador. Ambos lo ven en su actividad como una transferencia identificada.
#

Cambiarle la comisión a un comercio ya enrolado

Cambiar la oferta NO cambia lo que pagan los comercios que ya están enrolados: cada uno conserva la tasa que aceptó (la oferta nueva rige solo para los que se enrolen de ahora en más). Para cambiarle la tasa a uno existente hay que proponérsela y que la acepte.

1
En Cuentas de comercio, en la fila de ese comercio, tocás el ícono % (Proponer cambio de comisión).✓
2
El diálogo te muestra la comisión que ese comercio tiene vigente; cargás la nueva en Comisión propuesta (%) y tocás Enviar propuesta.✓
3
Al comercio le llega la propuesta y la ve en su cuenta. Vence a los 30 días y, mientras siga pendiente, su fila muestra el chip Propuesta pendiente con el porcentaje ofrecido.✓
4
Recién cuando la acepta empieza a regir. Hasta entonces sigue pagando la tasa vieja.✓
Pantalla Cuentas de comercio: una tabla con el comercio, la fecha de alta, la columna Comisión y los íconos de acción.
Portal → Cuentas de comercio. La columna Comisión muestra la tasa que aceptó cada comercio: acá el comercio paga 12% aunque la comisión configurada hoy sea 11%. El ícono % de la fila abre la propuesta de cambio.
Diálogo "Proponer cambio de comisión" del Portal, con la comisión vigente del comercio y un campo para la comisión propuesta.
El diálogo te recuerda la comisión vigente de ese comercio antes de que propongas otra.
Podés tener una sola propuesta pendiente por comercio: proponer de nuevo el mismo porcentaje no crea nada (es idempotente), y proponer uno distinto reemplaza la anterior. También podés cancelarla mientras siga pendiente.
Ver ejemplo
curl
# Proponerle 3,5% a un comercio ya enrolado
curl -X POST {{integration-admin-url}}/my-integration/distribution/commission-change/{integrationClientUserId} \
  -H "Authorization: Bearer {admin_id_token}" \
  -d '{ "percentage": 3.5 }'

# Cancelar la propuesta mientras siga pendiente
curl -X DELETE {{integration-admin-url}}/my-integration/distribution/commission-change/{integrationClientUserId} \
  -H "Authorization: Bearer {admin_id_token}"
#
Por qué no estoy cobrando

Cuando algo falta, el split no rompe el pago: se marca como salteado y el cobro del comercio sigue normal. Por eso conviene revisar estas causas antes de buscar el problema en tu backend.

  • No hay recaudador aceptado — La invitación quedó pendiente o nunca se envió. Revisá el estado en Distribución: tiene que decir aceptado, no pendiente.
  • El invitado no puede recibir fondos — Una cuenta liviana (creada solo para pagar, sin alta completa) no puede ser recaudadora: al aceptar la invitación se rechaza. Usá una cuenta de ChytaPay con alta completa.
  • El recaudador no tiene cuenta con CVU — Si la cuenta destino no tiene una cuenta operativa con CVU, no hay dónde acreditar y el split se saltea.
  • El comercio se enroló antes de que existiera la comisión — Ese comercio no aceptó ninguna tasa, así que no paga. Proponele el cambio de comisión desde Cuentas de comercio.
  • Borraste la oferta — Borrar la oferta solo frena a los comercios que se enrolen de ahí en más: los que ya la aceptaron siguen pagando su tasa. Para frenar a uno existente, proponele 0% y que lo acepte.