Deja que la IAlo conecte.

Eres mi desarrollador. Ayúdame a aceptar pagos en cripto en mi sitio web con blockwallets (los clientes pagan en USDT, USDC, BTC y otras 14 monedas; a mí se me acredita en dólares estadounidenses).

## Sobre mí
- Mi sitio está hecho con: No estoy seguro. Mira primero mi proyecto, dime con qué está hecho y luego empieza.
- Cómo quiero cobrar: Crea una factura al finalizar la compra y redirige al cliente a la página de pago de blockwallets; cuando llegue el dinero, blockwallets llamará a mi servidor y yo marcaré el pedido como pagado y lo enviaré.
- No soy programador. En cada paso, dime qué archivos cambiaste y qué tengo que hacer yo (por ejemplo, dónde poner las variables de entorno). No cambies demasiado de una vez.
- AGENTS.md en la raíz del proyecto contiene las reglas de integración de blockwallets; léelo primero, y lee https://blockwallets.io/llms-full.txt para los detalles.

## Lee primero la documentación; no adivines la API de memoria
- Documentación de integración completa (Markdown): https://blockwallets.io/llms-full.txt
- Reglas de integración y errores comunes: https://blockwallets.io/agents.md
- Si el sitio ya usa Cryptomus, NOWPayments o Coinbase Commerce, cámbialo a la API compatible correspondiente en lugar de reescribirlo: https://blockwallets.io/docs/migrate.md?lang=en
- Si no puedes abrir un enlace, dímelo y pegaré el contenido.

## Puntos clave (donde suelen fallar las integraciones)
1. Todos los endpoints son POST + JSON en https://blockwallets.io. Cabeceras: merchant = el UUID del merchant, sign = md5(base64(cuerpo de la petición) + API key). Firma exactamente la cadena JSON que envías; no la vuelvas a serializar después de firmar.
2. Crea una factura con POST /v1/payment. Obligatorios: amount (una cadena con hasta dos decimales, p. ej. "42.00"), currency ("USD"), order_id (mi número de pedido: letras, dígitos, - y _, hasta 100 caracteres). Pasa también url_callback (la URL del webhook) y url_success (a dónde vuelve el cliente tras pagar). Redirige al cliente a result.url.
3. Si se llama de nuevo con el mismo order_id se devuelve la misma factura, así que los reintentos son seguros y nunca crean una segunda factura.
4. Hay que verificar las firmas de los webhooks: analiza el JSON del webhook, quita el campo sign, vuelve a codificar el resto como lo hace json_encode de PHP (compacto, caracteres no ASCII sin escapar, / escapada como \/), y md5(base64(codificado) + API key) debe ser igual a sign. Olvidar escapar / es el error más común.
5. Marca el pedido como pagado solo cuando status sea paid o paid_over, usando payment_amount_usd. El mismo webhook puede llegar más de una vez: deduplica por uuid + status. Responde con un estado 2xx una vez procesado.
6. Guarda el ID del merchant y la API key en variables de entorno (p. ej. BW_MERCHANT, BW_API_KEY); nunca los escribas en el código ni los subas al repositorio. Antes, añade el dominio de la URL del webhook en “Dominios del sitio web”, dentro de “Desarrolladores › Integración y claves” del panel.
7. Haz que todo funcione primero con las credenciales de Test (testnets, sin dinero real); pasa a Live solo cuando yo lo confirme.

## Cuando termines, revisa cada punto y dime el resultado
- [ ] Crear una factura de prueba con las credenciales de Test y obtener el enlace de la página de pago (result.url)
- [ ] Abrir la página de pago y pulsar “Simular pago” → importe completo
- [ ] Mi servidor recibe un webhook con status paid y la firma se verifica
- [ ] El pedido correspondiente queda marcado como pagado
- [ ] Si el mismo webhook llega otra vez (reenvíalo desde “Desarrolladores › Registro de webhooks” en el panel, o con POST /v1/payment/resend), no se envía dos veces

Si algún punto falla, dime dónde se atasca y el mensaje de error exacto antes de cambiar nada más.