Skip to content

Docs: align guides with recent platform releases#17

Merged
next-devin merged 4 commits into
mainfrom
docs-release-sync
Jul 21, 2026
Merged

Docs: align guides with recent platform releases#17
next-devin merged 4 commits into
mainfrom
docs-release-sync

Conversation

@next-devin

Copy link
Copy Markdown
Contributor

Summary

  • update NEXT Payments APM coverage for Swish, iDEAL, and Bancontact
  • retire legacy checkout, card-throttle, and MaxMind setup guidance
  • document automatic currency pricing and current Campaigns navigation and analytics behavior

Validation

  • npm run audit-developer-links
  • npm run validate-links
  • npm run build
  • public-boundary scan for private references and legacy brand terms

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jul 21, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
nextcommerce-docs 4074bc6 Commit Preview URL

Branch Preview URL
Jul 21 2026, 06:50 AM

@next-devin
next-devin marked this pull request as ready for review July 21, 2026 06:36

### Address Autocomplete

Enable address autocomplete to suggest matching addresses while a customer types. When the customer selects a suggestion, checkout fills the city, state or region, postal code, and country fields.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: Address autocomplete field list is incomplete

The description only lists city, state or region, postal code, and country fields, but address-autocomplete services typically also fill the street address (address line 1 / civic number). The missing reference to the street address field could mislead merchants about which fields are populated and may leave gaps if the implementation only fills the four fields listed here. Confirm against the implementation and either expand the list to include the street address or explicitly call out that the street field is not auto-filled.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.


* Assign a Gateway Group to use as the default on your storefront with the **Default Gateway Group** setting. Assigning a Gateway Group will override any previously configured "Default" gateway for each currency.
* Set the **Throttle Attempts for Declining Bankcards** flag, to limit a cardholder from re-attempting an already-declined transaction more than 4 times in a single session.
* Card payment throttling allows three failed attempts per card within ten minutes. Further attempts with that card are blocked until the window passes.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: Possible loss of configurability for card-payment throttling

The previous bullet documented a configurable Throttle Attempts for Declining Bankcards flag, allowing merchants to enable or adjust the threshold. The replacement sentence describes throttling as a hardcoded platform rule ("three failed attempts per card within ten minutes"), which removes the documented setting. If throttling is still configurable in Settings > Payments (or has been migrated to a different location), merchants and developers reading this guide lose the path to that option. Confirm whether the setting still exists, and if so, restore a reference to it (e.g., the flag toggle and where it lives) alongside the new rule summary.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

### Campaigns App Logs

From the Campaigns App sidebar, select **Logs**. The activity logs show recent Campaigns API requests and responses for debugging checkout, payment, upsell, and tracking behavior.
Open **Developer > Logs** from a campaign to inspect its recent Campaigns API requests and responses. The app-level **Logs** view can be used when you need to investigate activity across campaigns.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Unclear navigation path for the "app-level" Logs view

The new sentence reads: "Open Developer > Logs from a campaign to inspect its recent Campaigns API requests and responses. The app-level Logs view can be used when you need to investigate activity across campaigns." The campaign-scoped path (Developer > Logs) is clear, but the "app-level Logs view" is not tied to a specific UI location. Earlier in this page the Campaigns App sidebar items mentioned are Settings (line 45); there's no sidebar/log mention to anchor the reader. Consider naming the exact navigation (e.g., "open Campaigns App from the sidebar and choose Logs" or the equivalent menu path) so merchants can find it.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

Next Commerce supports a variety of global gateways for bankcard transactions, encompassing credit and debit cards such as Visa, Mastercard, AMEX, Discover, Maestro, JCB and more.

Beyond bankcards, Next Commerce supports [**Alternative Payment Methods**](/docs/features/payments/stripe-apms) including **Buy Now, Pay Later** options (Affirm, Klarna), digital wallets (TWINT, Stripe Link, [Apple Pay](/docs/features/payments/apple-pay), [Google Pay](/docs/features/payments/google-pay)), [PayPal](/docs/features/payments/paypal), and European bank payment methods.
Beyond bankcards, Next Commerce supports [**Alternative Payment Methods**](/docs/features/payments/stripe-apms), including Buy Now, Pay Later options such as Affirm and Klarna; local methods such as TWINT, Swish, iDEAL, and Bancontact; Stripe Link; [Apple Pay](/docs/features/payments/apple-pay); [Google Pay](/docs/features/payments/google-pay); and [PayPal](/docs/features/payments/paypal).

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Grouping TWINT with iDEAL/Bancontact as "local methods" may mislead about availability

The new sentence groups "TWINT, Swish, iDEAL, and Bancontact" under "local methods such as…" Without qualification, this could read as if all four are similarly available across gateways. According to the APM table (lines 13-21) and the dedicated stripe-apms page, TWINT and Swish are NEXT Payments exclusive while iDEAL and Bancontact are available on both NEXT Payments and Stripe. Consider tightening the wording (e.g., "local methods such as the NEXT Payments-only TWINT and Swish, and the cross-gateway iDEAL and Bancontact") to avoid merchants expecting TWINT/Swish on Stripe.


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

description: "Track the traffic and performance of your campaigns in detail"
---
To set up Campaign Analytics on your custom funnels, from the Campaigns App main list view, click on your campaign name, or choose **View**, then **Integration.**
To set up Campaign Analytics on a custom funnel, open the campaign and select **Developer > Session Tracking**.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

SUGGESTION: Navigation path "Developer > Session Tracking" should be verified against the product UI

The new instruction tells users to select Developer > Session Tracking to set up Campaign Analytics on a custom funnel. If this exact menu path has not been product-verified, merchants may not find the option (the prior flow referenced View > Integration which has been removed). Confirm the menu path against the current Campaigns App UI before merge; if it differs, update to the actual navigation (for example, the documented path on line 84 of apps/campaigns-app/index.mdx implies Developer > Logs is a sibling, so the SDK/session-tracking item lives next to it).


Reply with @kilocode-bot fix it to have Kilo Code address this issue.

@kilo-code-bot

kilo-code-bot Bot commented Jul 21, 2026

Copy link
Copy Markdown

Code Review Summary

Status: No Issues Found | Recommendation: Merge

All 5 issues from the previous review at 0d8951c have been resolved by the incremental commit 4074bc6 ("docs: address review clarity"):

  • checkout-settings-and-policies.mdx (line 31): Street address is now included in the autocomplete field list.
  • add-payment-providers.mdx (line 70): Restored the configurable Throttle Attempts for Declining Bankcards flag.
  • campaigns-app/index.mdx (line 84): App-level Logs path is now specified as "Logs from the Campaigns App submenu".
  • features/payments/index.mdx (line 9): TWINT and Swish are correctly scoped to NEXT Payments; iDEAL and Bancontact noted as cross-gateway.
  • campaigns-app/campaign-analytics.mdx (line 5): Session Tracking instruction no longer uses an unverified "Developer > Session Tracking" path.

No new issues found in the incremental diff.

Incremental Files Reviewed (5 files)
  • content/docs/apps/campaigns-app/campaign-analytics.mdx
  • content/docs/apps/campaigns-app/index.mdx
  • content/docs/features/payments/index.mdx
  • content/docs/start-here/get-started/add-payment-providers.mdx
  • content/docs/start-here/get-started/checkout-settings-and-policies.mdx
Previous Review Summaries (2 snapshots, latest commit 0d8951c)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit 0d8951c)

Status: 0 New Issues Found | Recommendation: Informational

Overview

Severity Count
CRITICAL 0
WARNING 0
SUGGESTION 0

The latest incremental commits on docs-release-sync (between previous review 3ab0880 and current HEAD 0d8951c) consist solely of deletions: the Fraud Screening Has Moved stub under content/docs/apps/maxmind-minfraud.mdx, the full content/docs/features/payments/fraud-screening.mdx page, and the corresponding fraud-screening entry in content/docs/features/payments/meta.json. No new or modified + lines remain in the diff, so no new inline review comments are warranted from this incremental pass.

The 5 previously reported inline findings (address autocomplete completeness, card-throttle configurability, Campaigns Logs navigation, APM grouping, and Session Tracking navigation) target files outside this incremental diff and remain valid against current HEAD. They are not duplicated here.

Incremental Files Reviewed (3 files)
  • content/docs/apps/maxmind-minfraud.mdx - 0 new issues (file deletion)
  • content/docs/features/payments/fraud-screening.mdx - 0 new issues (file deletion)
  • content/docs/features/payments/meta.json - 0 new issues (entry removal)

Previous review (commit 3ab0880)

Status: 5 Issues Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 2
SUGGESTION 3
Issue Details (click to expand)

WARNING

File Line Issue
content/docs/start-here/get-started/checkout-settings-and-policies.mdx 31 Address autocomplete field list is incomplete — missing the street address from the populated-fields list.
content/docs/start-here/get-started/add-payment-providers.mdx 70 Possible loss of configurability for card-payment throttling — prior flag documentation removed in favor of hardcoded description.

SUGGESTION

File Line Issue
content/docs/apps/campaigns-app/index.mdx 84 Unclear navigation path for the app-level Logs view — exact menu path not stated.
content/docs/features/payments/index.mdx 9 Grouping TWINT with iDEAL/Bancontact as "local methods" may mislead about gateway availability.
content/docs/apps/campaigns-app/campaign-analytics.mdx 5 Navigation path "Developer > Session Tracking" should be verified against the product UI.
Files Reviewed (12 files)
  • content/docs/apps/campaigns-app/campaign-analytics.mdx - 1 issue
  • content/docs/apps/campaigns-app/index.mdx - 1 issue
  • content/docs/apps/maxmind-minfraud.mdx - 0 issues (stub redirect, doc-valid)
  • content/docs/apps/meta.json - 0 issues (navigation update)
  • content/docs/features/payments/fraud-screening.mdx - 0 issues (new doc, no defects in changed code)
  • content/docs/features/payments/index.mdx - 1 issue
  • content/docs/features/payments/meta.json - 0 issues (navigation update)
  • content/docs/features/payments/stripe-apms.mdx - 0 issues on changed lines (table and section wording verified against body content)
  • content/docs/meta.json - 0 issues (navigation update)
  • content/docs/start-here/get-started/add-locations-and-languages.mdx - 0 issues
  • content/docs/start-here/get-started/add-payment-providers.mdx - 1 issue
  • content/docs/start-here/get-started/checkout-settings-and-policies.mdx - 1 issue
  • package-lock.json - skipped (generated lockfile; js-yaml bumped 4.2.0 -> 4.3.0 and transitive 3.14.2 -> 3.15.0)

Fix these issues in Kilo Cloud


Reviewed by minimax-m3 · Input: 23.2K · Output: 1.6K · Cached: 178.9K

@next-devin
next-devin merged commit f57a9bc into main Jul 21, 2026
3 checks passed
@next-devin
next-devin deleted the docs-release-sync branch July 21, 2026 06:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant