Stablecoins en tu pago BTCPay.

Instalar

1. Descarga BTCPayServer.Plugins.WhollyCrypto.btcpay y compruébalo con el archivo de la versión SHA256SUMS. Usa el archivo del plugin, no el ZIP del código fuente de GitHub.
2. Como administrador de BTCPay, abre Manage Plugins → Upload Plugin, sube el archivo y reinicia BTCPay.
3. Selecciona una tienda → Plugins → Wholly Crypto. Instalar por sí solo no conecta una tienda.

Las actualizaciones usan el mismo proceso de subida. Actualizar el software de comercio Wholly no actualiza el plugin BTCPay.

Conectar una tienda

1. En Wholly, crea un proyecto y tienda habilitados con métodos aceptados, wallets con copia de seguridad, tipos de cambio y confirmaciones. Usa una instalación de comercio actual; este conector está diseñado para la API 6.4.5.
2. Copia los UUID de proyecto y tienda desde Tienda → Básico → IDs API. Crea una credencial API de lectura/escritura limitada al proyecto. Activa Tienda → IPN y copia su secreto de firma, no un secreto de webhook.
3. En los ajustes Wholly de BTCPay, introduce esos valores y los orígenes de tu API y página de pago, como https://api.example.com y https://pay.example.com. Usa HTTPS público en el puerto 443; sin rutas.
4. Activa Ofrecer Wholly Crypto al pagar, guarda y después Probar acceso de lectura. Si quieres, elige un subconjunto de los métodos aceptados por la tienda.

Permite notificaciones HTTPS desde tu servidor Wholly a BTCPay a través de ambos firewalls. El plugin proporciona la URL de notificación. No apliques a esa ruta accesos de navegador, CAPTCHA ni Basic Auth; las comprobaciones de firma deben seguir activadas.

Pago integrado

El pago en página completa es la opción predeterminada, especialmente útil para apps de wallets móviles. Para un iframe:

1. En Wholly, en Tienda → Avanzado, activa Permitir pago integrado. Añade el origen HTTPS exacto de tu BTCPay a Orígenes HTTPS permitidos, sin ruta ni comodín.
2. En los ajustes del plugin de BTCPay, elige Pago del cliente → Pago integrado (iframe) y guarda.
3. Prueba una factura nueva. Las facturas existentes conservan su modo de visualización original. Abrir pago completo sigue disponible para la misma factura si el marco no puede cargar.

Los mensajes del navegador y los enlaces de retorno sirven para navegar, nunca demuestran el pago.

Comprobar el flujo de pago

Crea una factura fiat pequeña y positiva en una tienda de pruebas. Selecciona Stablecoins y cripto · Wholly. Verifica la página de pago, IPN firmado y la verificación API hasta la confirmación. Entrega solo a partir de la factura liquidada de BTCPay, una vez por pedido.

Probar acceso de lectura no prueba la creación de facturas ni IPN. Usa Conexión y Pagos vinculados para ver errores seguros, referencias de pedidos y comprobaciones de pagos.