Errors

BTCPay checkout is not enabled — add server URL, store ID, and API key

assertBtcpayCheckoutReady failed — isBtcpayCheckoutEnabled false.

BTCPay checkout is not enabled — add server URL, store ID, and API key

createBtcpay* helpers throw this when isBtcpayCheckoutEnabled() is false. Message points to Admin → Settings → Payment.

Why this happens

Same root cause as the short BTCPay checkout is not configured — this is the assert path used when starting a BTCPay invoice from code.

Diagnose and fix

1. Fill server URL, store ID, and API key; turn on BTCPay checkout; save.

2. Confirm the BTCPay instance is reachable from the app server.

3. Retry the purchase; member should redirect to BTCPay’s checkout page.

4. If enabled but no link returns, see BTCPay Server did not return a checkout link.

Related