PAY-12564: add GlobalMessage display rule to EmbeddedCheckoutV3AppearanceRules

[pabloe-crossmint]

Description

Mirrors the new appearance rule introduced in Paella-Labs/crossbit-main#27986 into the public @crossmint/client-sdk-base types.

Adds GlobalMessage to EmbeddedCheckoutV3AppearanceRules so integrators can opt in/out of global-message banners in the embedded checkout:

appearance: {
  rules: {
    GlobalMessage: {
      display: "visible", // or "hidden"
    },
  },
}

This is the SDK-side type that backs the runtime GlobalMessage behavior in the web checkout (Express Checkout now uses defaultVisible={false} and only renders the banner when rules.GlobalMessage.display === "visible").

Test plan

• pnpm --filter @crossmint/client-sdk-base build passes (after building workspace deps).
• pnpm exec biome check --diagnostic-level=error --max-diagnostics=200 packages/client/base/src/types/embed/v3/CrossmintEmbeddedCheckoutV3Props.ts passes.
• Added a changeset for @crossmint/client-sdk-base.

Package updates

• @crossmint/client-sdk-base: minor bump (new optional GlobalMessage rule in EmbeddedCheckoutV3AppearanceRules).

Link to Devin session: https://crossmint.devinenterprise.com/sessions/52f46c7183fa4e76a894c8d6c4b71f1a
Requested by: @pabloe-crossmint

[devin-ai-integration]

Original prompt from Peg

SYSTEM:
=== BEGIN THREAD HISTORY (in #help-payments) ===
Jorge (U0757E01YJV): hey team, flagging a memecoin checkout UX bug opensea hit: google pay + apple pay tabs silently swallow sardine pre-PSP rejections. card tab works fine.

looks like finalizePayment() in usePaymentProcessingCommon.tsx correctly fires setGlobalMessage({…, displayLocation: "bottom"}) on sardine rejection, but <GlobalMessage> is location-scoped, so it only renders if a matching <GlobalMessage displayLocation="bottom" /> is mounted nearby.

card tab mounts it in SubmitPaymentButton.tsx:60, but express-checkout subtree (ExpressCheckoutPaymentMethodContent.tsx) didn't → state set, no renderer, timed out invisible after 8s.

it seems to impact all 3 express-checkout providers (basis-theory, stripe, checkout-com) on both google pay + apple pay tabs.

proposed fix: <https://github.com/Paella-Labs/crossbit-main/pull/25629> to mount <GlobalMessage displayLocation="bottom" /> outside <FatalGlobalMessageGuard> in ExpressCheckoutPaymentMethodContent.tsx.

could you take a look?

Linear Asks (U064YQRSWJC): Jorge Villamil created a General Ask <https://linear.app/crossmint/issue/PAY-12564/fix-memecoin-checkout-ux-bug-for-googleapple-pay-tabs|PAY-12564> Fix memecoin checkout UX bug for Google/Apple Pay tabs

Jorge Villamil created a General Ask <https://linear.app/crossmint/issue/PAY-12564/fix-memecoin-checkout-ux-bug-for-googleapple-pay-tabs|PAY-12564>

[Slack unfurl — this is an automatic link preview, not a user message]
Preview of a link: https://linear.app/crossmint/issue/PAY-12564/fix-memecoin-checkout-ux-bug-for-googleapple-pay-tabs

Pylon (U08GKGR1JMQ): Synced as an internal thread for <https://app.usepylon.com/issues?issueNumber=7479|Issue #7479>. Messages from this thread will sync into the issue as internal conversations and are not visible to customers.

Synced as an internal thread for <https://app.usepylon.com/issues?issueNumber=7479|Issue #7479>. M... (7962 chars truncated...)

[changeset-bot]

🦋 Changeset detected

Latest commit: 4cbe793

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 16 packages

Name	Type
@crossmint/client-sdk-base	Minor
@crossmint/client-sdk-nextjs-starter	Patch
@crossmint/client-sdk-auth	Patch
@crossmint/client-sdk-react-base	Patch
@crossmint/client-sdk-react-native-ui	Patch
@crossmint/client-sdk-react-ui	Patch
@crossmint/client-sdk-verifiable-credentials	Patch
@crossmint/client-sdk-smart-wallet	Patch
@crossmint/common-sdk-auth	Patch
@crossmint/wallets-playground-expo	Patch
@crossmint/auth-ssr-nextjs-demo	Patch
@crossmint/wallets-quickstart-devkit	Patch
@crossmint/wallets-playground-react	Patch
@crossmint/server-sdk	Patch
@crossmint/wallets-sdk	Patch
crossmint-auth-node	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[devin-ai-integration]

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

• Address comments on this PR that start with 'DevinAI' or '@devin'.
• Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

• Disable automatic comment, CI, and merge conflict monitoring

[devin-ai-integration]

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no bugs or issues to report.

[greptile-apps]

_{Reviews (1): Last reviewed commit: "feat(base): add GlobalMessage display ru..." | Re-trigger Greptile}