Errors

BTCPay Server did not return a checkout link

createBtcpayInvoice succeeded at HTTP layer but checkoutLink/URL missing.

BTCPay Server did not return a checkout link

btcpay-api created or fetched an invoice but found no checkout link in the response.

Why this happens

BTCPay store misconfiguration, unexpected API response shape, permissions, or a BTCPay version/plugin issue. Credentials were present (not the “not configured” path).

Diagnose and fix

1. In BTCPay admin, create a test invoice manually; confirm checkout URLs work.

2. Verify API key permissions for the store; check app logs for the raw response.

3. Confirm store ID matches the store that should host checkouts.

4. Retry after fixing BTCPay; fall back to another payment method if needed.

Related