Pagar a autores y vendedores

Panel → Pagar a autores. Cuánto le debes a cada uno, cuánto está todavía en espera y cuánto se le puede mandar ya. Y cómo sale ese dinero: a mano, o por un proveedor de pagos.

Antes de mover dinero de terceros, consúltalo con un asesor. Esta guía explica qué hace el sistema; qué te exige la ley a ti, no.

De dónde sale lo que se le debe

Cada venta le apunta al vendedor su parte en su monedero, que es un libro de movimientos: venta, tu comisión, devoluciones. Se explica en Vender con otros. Lo que aquí se paga es el saldo de ese libro.

La espera: 30 días

El dinero de una venta no se puede cobrar hasta 30 días después. Lo cambia PCC_DIAS_ESPERA_PAGO.

Un reembolso o un contracargo llegan días después de la venta. Si el dinero ya ha salido, lo persigues a quien ya no lo tiene. Por eso se separan tres cifras:

• Ganado: el saldo del libro.
• En espera: lo que entró en los últimos 30 días.
• Disponible: la resta. Es lo único que se puede pagar.

El mínimo: 50 €

No se paga por debajo de 50 € disponibles. Lo cambia PCC_UMBRAL_PAGO, en céntimos (5000 de fábrica). Cada vendedor puede ponerse el suyo, pero no por debajo de 10 €: cada transferencia cuesta dinero, y mandar tres euros sale más caro que no mandarlos.

El perfil de cobro

Para cobrar, el vendedor rellena su perfil en su panel, en Cobros. Mientras le falte algo no se le paga, y la pantalla le dice exactamente qué:

• el nombre con el que factura y si es particular o empresa;
• el país donde reside a efectos fiscales y su dirección completa;
• su número de identificación fiscal;
• su fecha de nacimiento, si es particular, o el número de registro, si es empresa;
• cómo quiere cobrar —PayPal, banco o Wise—, a nombre de quién está la cuenta y la cuenta o el correo;
• aceptar que emitáis la factura en su nombre (lo explica el apartado siguiente).

Pedirlo al entrar es barato; pedírselo después a alguien que ya cobró y desapareció, imposible.

Algunas comprobaciones se hacen al escribirlo, no el día del pago:

• El IBAN se valida con su dígito de control, igual que hace el banco. Una cifra cambiada se descubre al guardarlo.
• Para PayPal hace falta un correo válido.
• La cuenta se guarda cifrada. En pantalla solo se ven los cuatro últimos caracteres. Se cifra con PCC_CLAVE_CIFRADO (o JWT_SECRET si no está): si cambias esa clave, las cuentas ya guardadas no se pueden leer y hay que pedirlas otra vez.

Países a los que no se paga

Hay una lista fija de países a los que el sistema no deja pagar: Rusia, Bielorrusia, Irán, Corea del Norte, Siria, Cuba, Afganistán, Sudán y Birmania. Con uno de ellos el perfil no se guarda.

Esa lista no sustituye a comprobar a quién le mandas dinero. Qué controles te tocan es otra pregunta para tu asesor.

La autofacturación

El perfil pide que el vendedor acepte que emitáis la factura en su nombre. Sin esa aceptación no se le paga. Se guarda la fecha en que la dio, y una vez dada ya no se puede desmarcar desde su panel.

El sistema guarda el consentimiento; no genera esa factura. Cómo la emites, y si te conviene hacerlo así, lo decides con tu asesor.

Parar los pagos de alguien

Puedes bloquear los pagos de un vendedor. Hay que escribir el motivo, y al vendedor le llega un correo con él. Lo mismo cuando un pago falla. El dinero sigue en su monedero; el correo se lo dice.

Va así a propósito: no hay forma de parar el dinero de alguien en silencio. Al desbloquearlo, se vuelve a mirar su perfil: si le falta algo, sigue sin poder cobrar.

Hoy no tiene botón en el panel: se hace con POST /gestion/cobros/vendedores/<id>/bloquear y el motivo, y se deshace con la misma ruta y accion: "desbloquear".

Cómo sale el dinero

Hay dos modos, y se elige con PCC_CARRIL_PAGO.

Sin carril (de fábrica): lo paga una persona

Sin PCC_CARRIL_PAGO, el sistema no mueve dinero de banco. Lleva la cuenta, programa el pago y espera a que lo hagas tú.

1. En Panel → Pagar a autores sale cada vendedor con saldo: ganado, en espera, disponible y, si no se le puede pagar, por qué.
2. Pagar programa un pago por todo lo disponible. Queda programado, no hecho.
3. Haces tú la transferencia, por el medio que tenga en su perfil.
4. Confirmas el pago con su referencia (la del banco, la de PayPal). Es entonces, y no antes, cuando sale del monedero.

Hoy esa confirmación no tiene botón en el panel: se hace con POST /gestion/cobros/pagos/<id> y la referencia. No la anotes además como liquidación en la ficha del vendedor: se le restaría dos veces.

El pago sale del libro al confirmarse, no al programarse. Si se restara al programarlo y la transferencia fallara, el vendedor se quedaría con el saldo a cero y sin dinero.

El vendedor también puede pedir una retirada desde su panel. Pasa por las mismas comprobaciones: perfil completo, espera cumplida y mínimo alcanzado. Cada vendedor puede tener un solo pago en marcha a la vez, y desde tu panel, uno por mes. Lo decide la base de datos, no el navegador: un doble clic no paga dos veces.

Si un pago que había salido vuelve —cuenta rechazada, PayPal sin reclamar, el banco lo devuelve semanas después—, no se borra: se apunta el reingreso en el monedero, que es como se lleva un libro.

Y el vendedor puede descargar sus movimientos en CSV, con fecha, concepto e importe, para su contabilidad.

Con carril: lo paga el proveedor

Con PCC_CARRIL_PAGO=stripe o PCC_CARRIL_PAGO=mangopay, el dinero del vendedor lo custodia el proveedor, en una cuenta a su nombre, y es el proveedor quien le paga. Cambian tres cosas:

• El vendedor se da de alta en el proveedor desde su panel, en Cobros. Recibe un enlace para verificar su identidad; esa verificación la hace el proveedor, no tú. Hasta que termina, el proveedor no le paga nada.
• Al cobrar cada pedido, su parte se le transfiere a su monedero del proveedor. El dinero no se queda esperando en tu cuenta. Si aún no está verificado, su parte se queda apuntada en el libro, sin transferir, y se le transfiere en cuanto se verifica (y cada noche, por si acaso). Lo mismo con una transferencia que falló. Lo que tiene algún reembolso no se reintenta solo: con uno parcial se transferiría la parte entera, así que eso lo mira una persona.
• Pagar manda el pago de verdad. El botón de Panel → Pagar a autores es el mismo, pero ahora el proveedor lo envía a su banco. Si la conexión se corta a medias, el pago no se da por fallido —puede haber salido—: se deja vivo, y al reintentarlo viaja con la misma referencia, que es lo que impide pagar dos veces.

Con carril, tu libro pasa a ser el espejo del saldo del proveedor: se apunta lo que el proveedor confirma.

Stripe

El secreto del aviso es el del endpoint del carril, no el de la pasarela con la que cobras: en Stripe cada endpoint firma con el suyo. Si solo tienes el carril, vale también STRIPE_WEBHOOK_SECRET.

El vendedor tiene una cuenta conectada de tipo Express. El reparto de cada pedido va como una transferencia por vendedor, porque un pedido puede llevar piezas de varios.

Según las condiciones que el propio carril recoge, una plataforma europea solo puede pagar a cuentas del Espacio Económico Europeo, Reino Unido, Estados Unidos, Canadá y Suiza. Para el resto está Mangopay.

Mangopay

Antes de dar de alta a un vendedor se le pregunta a Mangopay si su país admite altas y pagos. Si no, se dice en ese momento, no el día del primer pago. Y no paga a nadie hasta que el vendedor completa su verificación.

El aviso del proveedor

El proveedor avisa de cómo acabó cada pago en:

<PCC_BACKEND_URL>/carriles/stripe/avisos
<PCC_BACKEND_URL>/carriles/mangopay/avisos

Es una dirección pública, porque la llama el proveedor. Por eso nada se da por bueno sin comprobarlo:

• Stripe firma sus avisos. Se comprueba la firma con el secreto, se ignora cualquier firma que no sea la v1 y se rechaza un aviso de más de 5 minutos. Uno que no cuadra se contesta con un error y no toca nada.
• Mangopay no firma, y avisa por GET, con el id en la dirección (la ruta atiende GET y POST). Cualquiera que conozca la dirección podría inventarse un aviso, así que el aviso solo sirve para saber qué pago mirar: se le vuelve a preguntar a Mangopay por ese pago, y lo que vale es lo que conteste.

La tarea diaria: cuadrar-pagos

Cada día a las 5:00, solo si hay carril, la tarea cuadrar-pagos reparte lo que se quedó sin repartir (ver arriba) y hace dos cosas que nadie más hace:

1. Pregunta por los pagos que quedaron a medias. Los programados que el proveedor ya recibió y que llevan más de 2 horas sin noticias. Un aviso puede no llegar nunca —se cayó la red, la dirección estaba mal—, y sin esto el vendedor se queda con el dinero en el aire.
2. Compara tu libro con el saldo del proveedor, vendedor por vendedor, y deja en el registro del servidor cada uno que no cuadra.

No corrige los descuadres: te los enseña. Dos libros que se contradicen y nadie mirando es el fallo caro de este montaje, y se descubre cuando alguien reclama, meses después. Mira ese registro.

Lo que hace falta

• Correo configurado (SMTP_*), para los avisos de bloqueo y de pago fallido.
• PCC_BACKEND_URL con la dirección pública del backend, si usas carril: es donde llegan los avisos.
• Y, antes de nada de esto, hablar con tu asesor.