feat: added cvcIcon prop

[ArushKapoorJuspay]

Type of Change

• Bugfix
• New feature
• Enhancement
• Refactoring
• Dependency updates
• Documentation
• CI/CD

Description

Adds a new merchant-facing cvcIcon option to the Payment Element that allows hiding the CVC/CVV icon inside the CVC input field.

Usage

elements.create("payment", {
  cvcIcon: "hidden"   // hides the CVC icon
  // cvcIcon: "default" or omit — shows the icon (default behaviour)
})

Changes

src/Types/PaymentType.res

• Defined a new cvcIconStyle variant type: DefaultCvcIcon | HiddenCvcIcon
• Added cvcIcon: cvcIconStyle to the options record
• Added cvcIcon: DefaultCvcIcon to defaultOptions
• Added "cvcIcon" to allowedPaymentElementOptions
• Added getCvcIconStyle parser with unknownPropValueWarning for invalid values
• Used getWarningString (consistent with redirectionInfo, branding patterns) in itemToObjMapper
  src/CardUtils.res
• Added optional ~cvcIcon: PaymentType.cvcIconStyle=DefaultCvcIcon parameter to setRightIconForCvc
• Returns React.null when cvcIcon is HiddenCvcIcon
  src/Payments/CardPayment.res
• Passes ~cvcIcon=options.cvcIcon to setRightIconForCvc
  src/Components/DynamicFields.res
• Destructures cvcIcon from optionAtom
• Passes ~cvcIcon to both setRightIconForCvc call sites (CardCvc and CardExpiryAndCvc branches)

How did you test it?

cvcIcon: "default"

cvcIcon: "hidden"

Checklist

• I ran npm run re:build
• I reviewed submitted code
• I added unit tests for my changes where possible

[semanticdiff-com]

Review changes with  

[github-actions]

🚫 Missing Linked Issue

Hi 👋 This pull request does not appear to be linked to any open issue yet.

Linking your PR to an issue helps keep the project tidy and ensures the issue is closed automatically.

✔️ How to fix this

• Add a keyword like Fixes #123 or Closes #456 to your PR description or a commit message.
• Or link it manually using the "Linked issues" panel in the PR sidebar.

✅ Tip: You can link multiple issues.
🚫 Note: If only one issue is linked, it must be open for this check to pass.

Once linked, this check will pass automatically on your next push or when you re-run the workflow.

Thanks for helping maintainers! 🙌