Skip to Content
Platform.Ontology

Payment Request API

Opens the browser's native pay sheet with saved cards and addresses.

Works without askingPayments and shoppingCheckoutWeb browsersWhile you use it

In one line

Can open the browser's pay sheet with saved cards and addresses you pick

Opens the browser's native pay sheet with saved cards and addresses.

The site sees only what the person approves: card or wallet token, shipping, email and phone if requested.

What it can and can't do

What the user does: You tap Pay or a wallet button at checkout.

It can

  • Show a pay sheet with your saved cards, wallets and addresses
  • Ask for your name, email, phone and shipping address
  • Send the store the details you approve

It cannot

  • See all your saved cards at once
  • Pay without you tapping Pay in the sheet
  • Work the same in every browser; some show a limited sheet
  • Keep the details after the payment ends

How it differs between platforms: Chrome, Edge, Safari and Samsung Internet show it. Firefox shows only a partial version.

Browser support

BrowserStatusFirst versionReleasedNote
ChromeSupported602017-07-25None
EdgeSupported152017-04-05None
FirefoxBehind a flag55Not listedBehind a flag
SafariSupported11.12018-04-12None
Safari on iPhoneSupported11.32018-03-29None
Chrome on AndroidSupported532016-09-07None
Samsung InternetSupported6.02017-08-23Chrome Android 53

How a site asks for it

APInew PaymentRequest(methodData, details, options).show(), canMakePayment(), hasEnrolledInstrument()
Permissions policypayment
Browser compat keysapi.PaymentRequest
How access is grantedprompt
What the user seesBrowser payment sheet listing cards, addresses and wallets
Needs a secure context (HTTPS)Yes
Needs a user gestureYes
How long it lastsPer origin
How to take it backSite settings
Inside an iframeSame as top level; cross-origin iframes need a permissions policy where listed

Typical flow

  1. Call the API
  2. Browser applies its access rules
  3. Page receives the result

Data you get

What comes back: Opens the browser's native pay sheet with saved cards and addresses.
Shape: object
How often: on demand

FieldTypeUnitRangePrecision
methodNamestringNonebasic-card (removed), https://google.com/pay, https://apple.com/apple-pay, secure-payment-confirmationNot listed
detailsobjectNonetoken or card dataper handler
shippingAddressobjectNonecountry, region, city, postalCode, recipient, phoneif requestShipping
payerEmail / payerPhone / payerNamestringNonefree textif requested

Technical limits

  • Must be called from a user gesture
  • Only methods the browser supports
  • Merchant never sees the full card number from Chrome autofill without CVC

The story

What it is

The browser shows its own pay sheet with your saved cards and address.

For you

A pay sheet pops up from the browser with your saved cards and address. You pick, confirm and you are done without retyping.

For makers

Makers get faster checkouts and fewer typing errors. The browser holds the card, so the shop can lean on it for trusted wallets like Google Pay and Apple Pay.

Where you see it

TypeExampleApps
shoppingA store opens the browser pay sheet and finishes your order in one step.Shopify stores
deliveryA takeout site fills your address and card from the browser.None named
travelA booking site reads your name and email from the sheet.None named
gamesA game store buys coins with a saved card.None named
securityA shop only sees a token and not the full card number.None named
mediaA news site sells an annual pass in one tap.None named

Risks

  • Easy overspending
  • Shares contact details

What the platform says

Good uses and abuse

Legitimate uses

  • One tap checkout

Known abuse

  • Skimmers if site is compromised

Scores

ScoreValueMeaning
Sensitivity5 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction2 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2016, Chrome 53: Payment Request ships on Chrome Android
  • 2017, Chrome 60: Desktop
  • 2017-09, Safari 11.1: Safari via Apple Pay
  • 2022, Chrome: basic-card deprecated; Google Pay and other handlers remain

Sources

How well checked: Checked against real behavior.

On this page