Skip to content

feat: allow passkeys in the 3DS challenge iframe - #287

Merged
roshan-gorasia-cko merged 2 commits into
masterfrom
feat/3ds-challenge-iframe-passkeys
Nov 3, 2026
Merged

roshan-gorasia-cko merged 2 commits into
masterfrom
feat/3ds-challenge-iframe-passkeys

Conversation

@roshan-gorasia-cko

@roshan-gorasia-cko roshan-gorasia-cko commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Card scheme passkeys (Visa Payment Passkey, Mastercard Payment Passkey) run inside the EMV 3DS challenge and use WebAuthn. Browsers block WebAuthn in a cross-origin iframe unless the parent delegates it, so in our 3DS challenge iframe the passkey prompt never appears and cardholders fall back to a regular challenge (for example an OTP).

Changes

  • ActionHandler: the 3DS challenge iframe (ThreeDSChallengeFlow) now sets allow="payment *; publickey-credentials-get *; publickey-credentials-create *".
  • Other iframe actions (for example merchant iframe overrides) are unchanged.
  • Version bumped to 1.9.19.

Impact

  • Permissions use * because the frame redirects to issuer ACS origins that can't be listed in advance. A framed page can still only use passkeys for its own domain, and each use needs the cardholder to act on a browser prompt.
  • The attribute can't grant more than the merchant page allows: a merchant Permissions-Policy that disables these features still wins.
  • Browsers that don't recognise a feature ignore it (some may log a console warning).
  • If passkeys aren't available for the card or issuer, nothing changes.

Additional Context

🤖 Generated with Claude Code

roshan-gorasia-cko and others added 2 commits November 2, 2026 15:00
Browsers block WebAuthn in cross-origin iframes unless the embedder
delegates the permission, so scheme passkeys (Visa/Mastercard payment
passkeys run inside the 3DS challenge) silently fell back to OTP.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@roshan-gorasia-cko
roshan-gorasia-cko requested a balanced review from Copilot November 2, 2026 15:05
@roshan-gorasia-cko
roshan-gorasia-cko marked this pull request as ready for review November 2, 2026 15:06

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟢 Approval recommended

No active review issues are reported for the changes enabling passkeys in 3DS challenge iframes.

No open issues 🎉

What changed in this PR

This PR enables card-scheme passkeys in the SDK’s 3DS challenge iframe by delegating WebAuthn permissions, while leaving other iframe actions unchanged.

Changes:

  • Adds payment and WebAuthn permissions specifically to 3DS challenge iframes.
  • Adds tests for permission delegation, size overrides, and unaffected flows.
  • Bumps the package version to 1.9.19.
File Description
test/​support/​loadNamespace.ts Adds a minimal DOM shim for inspecting ActionHandler-created iframe attributes.
test/​processout/​actionhandler.test.ts Tests 3DS permissions and confirms other flows remain unchanged.
src/​processout/​actionhandler.ts Enables payment and passkey permissions for 3DS challenge iframes.
package.json Updates the version to 1.9.19.

Review effort: Balanced

@roshan-gorasia-cko
roshan-gorasia-cko merged commit 4fac03f into master Nov 3, 2026
6 checks passed
@roshan-gorasia-cko
roshan-gorasia-cko deleted the feat/3ds-challenge-iframe-passkeys branch November 3, 2026 16:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants