Integrar con un agente de IA

Integra TipTap Go en mi sitio para cobrar con un link de pago.

Antes de escribir código, lee estas dos fuentes:
- https://go.paytiptap.com/llms-full.txt (guía completa)
- https://go.paytiptap.com/api/v1/openapi.json (especificación)

Reglas:
- Usa SOLO endpoints que aparezcan en ese OpenAPI. Si no está ahí, no existe: no lo inventes ni lo deduzcas de Stripe.
- La API key va en el servidor, nunca en el navegador.
- Los montos son dólares con 2 decimales (25.00), no centavos.
- El header Idempotency-Key protege los COBROS (POST /v1/customers/{id}/charges), no los links: POST /v1/payment_links lo ignora y repetirlo crea OTRO link. Si crear el link da timeout, busca en GET /v1/payment_links si ya quedó creado antes de repetir el POST.

Criterio de aceptación: crear un link de pago con POST /v1/payment_links y mostrarme la URL que devuelve.

Agrega a mi sitio la recepción de webhooks de TipTap Go.

Lee https://go.paytiptap.com/llms-full.txt antes de empezar.

Requisitos, sin excepción:
- Verifica la firma del header Tiptap-Signature ANTES de confiar en el contenido: v1 es el HMAC-SHA256 de "${t}.${cuerpo_crudo}" con el secreto whsec_ del endpoint.
- Firma sobre el cuerpo CRUDO, antes de parsear el JSON. Si lo parseas y reserializas, la firma no coincide.
- Compara en tiempo constante y rechaza timestamps de más de 5 minutos.
- Responde 2xx en menos de 10 segundos y procesa después.
- Sé idempotente usando el header Tiptap-Delivery.

Maneja al menos payment.succeeded. Criterio de aceptación: un POST con firma inválida devuelve 400 y uno válido devuelve 200.

Quiero cobrar mensualidades recurrentes con TipTap Go desde mi sistema.

Lee https://go.paytiptap.com/llms-full.txt y https://go.paytiptap.com/api/v1/openapi.json.

Importante antes de diseñar:
- TipTap Go NO tiene endpoint de suscripciones. Los cobros recurrentes se arman con clientes y cobros: POST /v1/customers y POST /v1/customers/{id}/charges. No inventes /v1/subscriptions ni /v1/plans: no existen.
- OJO con el default: POST /v1/customers/{id}/charges SIN "use_saved_card": true NO cobra nada, solo genera un link para que el cliente pague. Si quieres cobrar el período de una vez, manda "use_saved_card": true — si no, vas a creer que cobraste y no cobraste.
- La tarjeta la registra el CLIENTE al pagar por un link de afiliación; no hay endpoint de tokenización. Si el cliente todavía no tiene tarjeta guardada, el cobro devuelve 409 con código no_saved_card: en ese caso manda el link en vez de reintentar.
- Cobrar la tarjeta guardada es un cargo real e inmediato. Manda SIEMPRE Idempotency-Key (una cadena de 8-255 caracteres; por ejemplo, derivada del periodo: "cobro-{customerId}-2026-08"): sin ella, dos llamadas iguales son dos cobros. Ante timeout, reintenta con LA MISMA llave. Pero si recibes 409 charge_unresolved, la misma llave solo repite ese 409: verifica en GET /v1/payments si el cobro existe y SOLO si no existe usa una llave nueva. Un rechazo (402 charge_declined) también queda guardado en la llave: para reintentar un cobro rechazado usa una llave nueva (p.ej. cobro-{customerId}-2026-08-intento-2).

Propón primero el diseño (dónde guardo el customer id, cómo programo el cobro del período, qué hago si falla) y espera mi visto bueno antes de escribir código.