Skip to content

Show hosted Visa approval with screenshots - #777

Open
ehfeng wants to merge 1 commit into
mainfrom
hypeship/visa-approval-walkthrough
Open

ehfeng wants to merge 1 commit into
mainfrom
hypeship/visa-approval-walkthrough

Conversation

@ehfeng

@ehfeng ehfeng commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Show the hosted Visa approval experience in the card payment docs: verification, explicit purchase consent, and completion. Add three screenshots of the actual hosted component with test data and simulated one-time-code verification, plus a link to a runnable sample app. The screenshots are visibly labeled and do not depict a real Visa passkey ceremony or charge.

Validated the Mintlify preview in Chromium: the page and all three screenshots load, with no runtime errors.

Merge kernel/cookbooks#12 before publishing this change so the sample link to main resolves.


Note

Low Risk
Documentation and imagery only in the card payment guide; no product or API behavior changes.

Overview
Pay with card now documents the hosted Visa spend_approval step: open the approval URL for the cardholder, complete Visa verification (passkey or one-time code), and explicitly approve the purchase before checkout continues.

The page adds three captioned screenshots of the KERNEL-hosted flow (verification, consent, and post-approval confirmation) using test data and simulated OTP—not passkey or real authorization. It also links to the cookbooks visa-purchase-approval sample, notes keeping the approval URL out of agent context, and spells out when to resume checkout (state.status === "ready", funding, expires_at, fill available), with a pointer to embedded CVC as a separate path.

Reviewed by Cursor Bugbot for commit cbb1355. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Nov 21, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
Kernel 🟢 Ready View Preview Nov 21, 2026, 7:00 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

@ehfeng
ehfeng marked this pull request as ready for review November 21, 2026 07:09
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 21, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-21T07:10:59.352275Z cbb1355 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: cbb1355c4d

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

<img src="/images/visa-purchase-approval/approved.png" alt="KERNEL hosted page confirming purchase approval" />
</Frame>

try the [hosted Visa approval sample app](https://github.com/kernel/cookbooks/tree/main/features/visa-purchase-approval). it keeps the API key on the server, creates one purchase, opens its returned approval link, and polls that purchase until it is ready to fill. you need an enrolled, eligible Visa payment method; the sample stops before merchant checkout submission.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Land the sample before publishing its link

If this documentation is published before kernel/cookbooks#12 merges, this main-branch URL returns a 404 and readers can't run the promised sample. The commit message explicitly identifies that ordering dependency, but nothing in this change enforces it, so land the cookbook change first or defer the link until the sample is available.

Useful? React with 👍 / 👎.

This branch was successfully deployed

1 active deployment
staging — cbb1355c Deployed Nov 21, 2026 by mintlify[bot]
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