Pagos fallidos de Stripe a Discord

Qué vas a tener

Un canal de Discord con un embed rojo cuando un cobro de factura falla: cliente, email, importe y tipo de evento.

No hace falta bot de Discord: basta un Incoming Webhook, una dirección secreta que Discord te da para publicar en un canal sin más permisos. Primero compruebas que el aviso se ve bien; conectar Stripe de verdad viene después.

Para el JSON del evento: Webhooks de Stripe.

Requisitos

Crea el webhook en Discord

1. Abre el canal (mejor uno dedicado, p. ej. #billing-fallos).
2. Engranaje del canal → Integraciones → Webhooks → Nuevo webhook.
3. Nombre claro, por ejemplo Stripe fallos.
4. Copiar URL del webhook.

Esa URL es un secreto. No la pegues en issues, chats públicos ni en el repo.

Prueba el destino

Sustituye todo el valor entre comillas por la URL que te dio Discord (empieza por https://discord.com/api/webhooks/ — no la pegues encima del prefijo).

WEBHOOK_URL="pega-aqui-tu-url-completa"
curl -sS -o /dev/null -w "%{http_code}\
" -X POST "$WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d "{\"embeds\":[{\"title\":\"Pago fallido (prueba)\",\"description\":\"Cliente demo · 19.00 EUR\
Evento: invoice.payment_failed\",\"color\":15158332,\"fields\":[{\"name\":\"Cliente\",\"value\":\"cus_demo\",\"inline\":true},{\"name\":\"Email\",\"value\":\"demo@example.com\",\"inline\":true},{\"name\":\"Importe\",\"value\":\"19.00 EUR\",\"inline\":true}]}]}"

Resultado esperado: Discord responde 204 y en el canal aparece el embed de prueba.

Eso demuestra el formato del aviso y que el Incoming Webhook funciona. No demuestra que Stripe te haya entregado un evento firmado.

Qué mapearás desde Stripe

Cuando llegue un invoice.payment_failed real, los campos útiles de la factura suelen ser:

Detalle del evento: Webhooks de Stripe.

Engancha Stripe

Ya tienes el aviso pintado en Discord. Pero Stripe no puede hablar directamente con Discord: alguien tiene que recibir el evento, comprobar que viene de Stripe y traducirlo al formato del mensaje.

Para la otra mitad tienes tres caminos:

No-code (Zapier, Make, etc.)

Más rápido si no quieres escribir ni hospedar código; misma idea evento → mensaje.

Endpoint HTTPS propio

Stripe Dashboard → Developers → Webhooks → URL pública que verifique `Stripe-Signature` y luego haga POST a Discord.

Stripe CLI en local

Solo desarrollo: reenvía eventos a un proceso **tuyo** en un puerto; sin ese proceso, `listen` no completa el aviso a Discord.

Si tiras por el camino propio, el receptor hace esto — en el orden en que se enumera. No es código para copiar, es el guion:

1. Recibir POST del body raw.
2. Verificar firma con el signing secret (docs Stripe (se abre en una pestaña nueva)↗).
3. Si type === "invoice.payment_failed", mapear factura → embed (céntimos → unidades).
4. POST a tu Incoming Webhook de Discord.
5. Responder 2xx a Stripe pronto.
6. Deduplicar por evt_… o por invoice.id si no quieres un mensaje por cada reintento.

Ejemplo de CLI cuando ya tengas algo escuchando en un puerto local (p. ej. 4242):

stripe listen --forward-to localhost:4242/webhook
# en otra terminal:
stripe trigger invoice.payment_failed

Puedes parar tras la prueba del destino Discord y dejar el pegamento Stripe para cuando tengas dónde hospedar el receptor. Ver el evento en bruto: Webhooks de Stripe.

Seguridad

• Regenera el Incoming Webhook si la URL se filtra.
• Separa endpoints test y live en Stripe.
• No loguees la URL de Discord ni el signing secret.
• Piensa en reintentos: Stripe puede emitir varios payment_failed por la misma factura.

Errores habituales

Alternativas

Email de Stripe

Cero código; menos visible en el equipo.

Slack Incoming Webhook

Mismo evento, otro destino.

Bot de Telegram

Mismo evento hacia un chat o grupo, con token y chat_id.

Recursos