TryGhost/Ghost · error · Error

Failed to process gift checkout, please try again.

Error message

Failed to process gift checkout, please try again.

What it means

Thrown by checkoutGift() at line 677: the HTTP response was not ok AND the body had no structured errors[0] to rethrow. checkoutGift defensively parses the body as JSON (catching parse failures, e.g. an HTML proxy error page), so this branch fires when the backend returned a non-2xx with either an empty body or a JSON shape lacking errors[]. It is a 'something failed and we have no detail' signal.

Source

Thrown at apps/portal/src/utils/api.js:677

                },
                body: JSON.stringify(body)
            });

            let responseJson = {};
            try {
                responseJson = await response.json();
            } catch (e) {
                // response may not be JSON (e.g. HTML error page from proxy)
            }

            if (!response.ok) {
                const error = responseJson?.errors?.[0];

                if (error) {
                    throw error;
                }

                throw new Error('Failed to process gift checkout, please try again.');
            }

            if (responseJson.url) {
                return window.location.assign(responseJson.url);
            }

            throw new Error('Failed to process gift checkout, please try again.');
        },

        async checkoutDonation({successUrl, cancelUrl, metadata = {}, personalNote = ''} = {}) {
            const identity = await api.member.identity();
            const url = endpointFor({type: 'members', resource: 'create-stripe-checkout-session'});

            const metadataObj = {
                fp_tid: (window.FPROM || window.$FPROM)?.data?.tid,
                urlHistory: getUrlHistory(),
                ...metadata
            };

View on GitHub (pinned to 47d8b0e2ad)

Solutions

1. Open browser devtools → Network, find the create-stripe-checkout-session POST, and inspect the raw response status and body — the status code (502/504/404) localizes the layer.
2. If a proxy returned HTML, fix the proxy timeout/routing to reach Ghost's members API.
3. Check Ghost server logs around the request timestamp for a crash or unhandled error.
4. Confirm the tierId/duration/cadence sent are valid for the site's configured gift tiers.
5. Ensure the Portal is built against a Ghost backend whose members API returns the standard errors[] envelope.

Example fix

// before: empty fallback hides the HTTP status
if (!response.ok) {
    const error = responseJson?.errors?.[0];
    if (error) throw error;
    throw new Error('Failed to process gift checkout, please try again.');
}

// after: include status + snippet so triage is possible
if (!response.ok) {
    const error = responseJson?.errors?.[0];
    if (error) throw error;
    throw new Error(`Failed to process gift checkout (HTTP ${response.status}). Please try again.`);
}

// Pre-validate the gift inputs before posting
function validGiftInput({tierId, duration, cadence}) {
    return (typeof tierId === 'string' && tierId.length > 0) &&
        (duration !== undefined || (cadence === 'monthly' || cadence === 'yearly'));
}

function hasStructuredError(body) {
    return body && Array.isArray(body.errors) && body.errors[0];
}

try {
    await api.member.checkoutGift({tierId, duration, cadence, email});
} catch (err) {
    // No structured detail from backend — show generic + log status for triage
    showToast(err.message);
    console.error('gift checkout failed', err);
}

When it happens

Trigger: Reverse proxy/CDN returns a 502/503 HTML page (not JSON) in front of Ghost; Ghost returns a non-2xx with an empty body during an unhandled crash; a WAF blocks the gift-checkout POST and returns a plain-text challenge; the response body parse succeeded but didn't contain the expected errors[] envelope.

Common situations: Cloudflare/nginx in front of Ghost timing out on a slow Stripe session-creation call; Ghost worker crashed mid-request (OOM) leaving a truncated response; gift tier/duration combination rejected by a custom validation that doesn't return the standard error envelope; misconfigured base path so the POST hits a 404 HTML page.

Related errors

• Could not create Stripe checkout session
• redirectResult.error.message
• result.error.message
• Failed to fetch site data
• Failed to fetch recommendations

AI-assisted analysis of TryGhost/Ghost@47d8b0e2ad (2026-08-13). Data as JSON: /api/errors/f7dddc53741ad864. Report an issue: GitHub.