Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Note on API shape #99

Merged
merged 3 commits into from
Aug 10, 2021
Merged

Note on API shape #99

merged 3 commits into from
Aug 10, 2021

Conversation

ianbjacobs
Copy link
Collaborator

New note with background on current shape of API and setting expectation it will change.

Relates to issues #81 and #65 (but does not close them).

spec.bs Outdated
Comment on lines 372 to 383
<div class="note">This specification describes an API implemented
to support a Stripe pilot that began in December 2020. To quickly
provide support for that experiment, the Chrome team added SPC
support atop existing implementations of the Payment Request and
Payment Handler APIs. However, given findings from the pilot and
subsequent use case and requirements discussions, there is now
general agreement that SPC should be usable independent of Payment
Request. To foster more experimentation in a timely fashion we are
moving forward with the API in its current form, but we expect
(without a concrete timeline) that SPC will move away from its
Payment Request origins. For developers, this should improve
feature detection, invocation, and other aspects of the API.</div>
Copy link
Collaborator

Choose a reason for hiding this comment

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

That's a lot of information... Could it be simplified into this?

Suggested change
<div class="note">This specification describes an API implemented
to support a Stripe pilot that began in December 2020. To quickly
provide support for that experiment, the Chrome team added SPC
support atop existing implementations of the Payment Request and
Payment Handler APIs. However, given findings from the pilot and
subsequent use case and requirements discussions, there is now
general agreement that SPC should be usable independent of Payment
Request. To foster more experimentation in a timely fashion we are
moving forward with the API in its current form, but we expect
(without a concrete timeline) that SPC will move away from its
Payment Request origins. For developers, this should improve
feature detection, invocation, and other aspects of the API.</div>
<div class="note">This specification describes an API implemented
atop existing implementations of the Payment Request. We expect
(without a concrete timeline) that SPC will move away from its
Payment Request implementation to align better with WebAuthn.
For developers, this should improve feature detection, invocation,
and other aspects of the API.</div>

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

@rsolomakhin, I think the rationale / history is useful. I don't mind shortening it. Let me edit a bit...

spec.bs Outdated
Comment on lines 374 to 375
Request and Payment Handler APIs. There is now general agreement
that SPC should be usable independent of Payment Request. We
Copy link
Collaborator

Choose a reason for hiding this comment

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

Perhaps "There is not general agreement that using SPC independent of Payment Request should be considered" or "should be explored"? I don't want to make it sound like we have a concrete plan in place.

Copy link
Collaborator

@rsolomakhin rsolomakhin left a comment

Choose a reason for hiding this comment

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

LGTM! Thank you!

@ianbjacobs ianbjacobs merged commit fbcfa18 into main Aug 10, 2021
@stephenmcgruer stephenmcgruer deleted the api-shape branch August 16, 2021 13:20
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.

2 participants