56

So Safari offers Scan Credit Card feature on iOS8 with some credit card forms.

My question is, how does Safari determine when to offer this option?

So far I found that this option is available on Amazon and PayPal, but none of my credit card input forms were able to reproduce this behaviour.

Scan credit card option activation on a form

2
  • 1
    Did you serve up your test page over https:// with proper, not self signed certificate? That might help, please let us know.
    – barbazoo
    Commented Sep 1, 2014 at 2:24
  • I tried it over https but with a self signed certificate. I'll let you know if I manage to test it with a proper cert. Commented Sep 1, 2014 at 11:12

9 Answers 9

98
+50

After a bit of research with an iOS8 browser and Chrome emulation I figured it out partially. I know of some solutions, but I don't know for sure if there are other ways to do it. You'll have to thank Apple for the amazing lack of documentation around this.

Currently Netflix/Amazon have credit card scanning working properly. So I emulated an iOS8 user agent in my Chrome browser and inspected the markup of their credit card number field. Here's Netflix's:

<input name="cardNumber" smopname="num" id="cardNumber-CC" class="cardNumber" type="text" value="************0891" pattern="[0-9]*">

And here's Amazon's:

<input name="addCreditCardNumber" size="20" maxlength="20">

At that point I played around with a form served over HTTPS that I had control over and started setting attributes to see what would happen. Below, "works" means "successfully triggered card scan" and "doesn't work" means "did not trigger card scan":

  • name="addCreditCardNumber" => works
  • name="cardNumber" => works
  • name="cardnumber" => works
  • class="cardNumber" => does not work
  • type="cardNumber" => does not work
  • id="cardNumber", id="creditCardNumber", id="creditCardMonth", id="creditCardYear" => works

Since the name attribute drives form data and might impact the way server-side form processing works I highly recommend triggering credit card scan by setting your input id to cardNumber.

I would link to the relevant documentation...but hey! There's none (at least, not that I know of)

16
  • 2
    Thanks. I went for id='cardNumber' which seems to works fine. I was hoping to find documentation in the Safari developer center but there wasn't any mention of this feature that I could find Commented Sep 19, 2014 at 2:57
  • Thank you, this fills the cardNumber. But what about the other fields? How do you call the card expire or card owner name fields?
    – gklka
    Commented Nov 2, 2014 at 14:06
  • 1
    Sorry, but i tried your answer and it does not work. I have build a form with an inputfield like the one you wrote here. I use it within a https page which is not selfsigned. But the scan function does not appear within my iphone... Could you please describe it a bit more?
    – Niels
    Commented Jan 9, 2015 at 11:02
  • @gklka: See Eric's answer: IDs of "cardExpirationMonth" and "cardExpirationYear" (for expiration month and year, respectively) seem to do the trick. I haven't verified this myself yet. As soon as I do I'll edit my answer. Commented Jan 14, 2015 at 17:25
  • 1
    Just did a bit of playing, it seems in Safari, the placeholder also works. The pattern "card number" somewhere in the placeholder seems to trigger the auto-fill as well.
    – metahamza
    Commented Jun 2, 2015 at 22:19
24

I think your better bet is to use HTML5 Autocomplete Types on your inputs.

Stick to the credit card related types, and most modern browsers will auto recognize these fields for you, including Mobile Safari and the "Scan Credit Card" feature. Bonus is that you'll always get the correct keyboard on mobile devices too.

Example (note autocomplete, x-autocompletetype, and pattern attributes):

<input type="text" id="cc-num" autocomplete="cc-number" x-autocompletetype="cc-number" pattern="\d*">

<input type="text" id="cc-name" autocomplete="cc-name" x-autocompletetype="cc-full-name">

I also wrote a related blog post on this topic and built an HTML5 Autocomplete Cheatsheet.

2
  • 1
    Hi Ryan, do you know if credit card autofill show work on a single input field autocomplete="cc-exp" ? Commented Oct 26, 2015 at 12:43
  • @MarkSteggles I think that depends on the capabilities of the browser and/or 3rd party auto-fill plugin. Commented Feb 6, 2016 at 0:06
18

In addition to Arnaud Brousseau's answer, a search for "card number" in the iOS simulator files yields this file:

/Applications/Xcode.app/Contents/Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator.sdk/System/Library/PrivateFrameworks/SafariShared.framework/SafariShared

A quick run of strings on it reveals these strings which are certainly used for matching potential fields:

card number
cardnumber
cardnum
ccnum
ccnumber
cc num
creditcardnumber
credit card number
newcreditcardnumber
new credit card
creditcardno
credit card no
card#
card #
cvc2
cvv2
ccv2
security code
card verification
name on credit card
name on card
nameoncard
cardholder
card holder
name des karteninhabers
card type
cardtype
cc type
cctype
payment type
expiration date
expirationdate
expdate

and a bit further:

month
date m
date mo
year
date y
date yr

Can't quite see (with this naïve approach) any references to which attributes (id, name, placeholder...) or other metadata (label maybe?) are actually compared against this list. Also, with the exception of "name des karteninhabers", this is really very english-oriented, that's quite unusual for Apple IMHO.

11

Thanks to @barbazoo, the Scan Credit Card option will be available over https with a valid (not self signed) certificate.

1
  • this I'm sure will save people some headaches - but what does it need to have in the HTML to be detected as a credit card field? my credit card field isn't detected as being a credit card field Commented Sep 18, 2014 at 6:08
7

For the expiration fields, based on Arnaud's answer, I found that the expiration fields would be recognized from cardExpirationYear and cardExpirationMonth being in the id attribute.

This worked when the year and month are regular text inputs with the appropriate IDs. The month is populated as a 2-digit number and the year as a 4-digit number.

In a quick test using <select> tags, I found that it also populated the correct month and year.

<input type="text" id="cardNumber" placeholder="CC number">

<select id="cardExpirationMonth">
  <option value="01">01</option>
  <option value="02">02</option>
  ...
  <option value="11">11</option>
  <option value="12">12</option>
</select>

<select id="cardExpirationYear">
  <option value="2014">2014</option>
  <option value="2015">2015</option>
  ...
  <option value="2024">2024</option>
  <option value="2025">2025</option>
</select>

I don't know what other values will work in the option tags.

1

It's not about when, it's about how we can enable this feature in Safari browser.

Let's just talk about what happens when a form is submitted:

  1. Some browsers stores all input values with it's name attribute. And it will offer to autocomplete those fields when it encounters same named input elements.

  2. Some browsers scan for just autocomplete attribute for offering auto-completion and,

  3. Some others scan for an attribute like label or name for input elements too.

Now, autocomplete attribute can have a larger set of values including cc-name (Card name), cc-number, cc-exp, cc-csc (Security number - CVV) etc. (full list here)

For example, we could say to a browser that, this is card number field and it should offer autocomplete when possible and it should enable scan credit card feature as:

<label>Credit card number: 
  <input type=text autocomplete="cc-number">
</label>

In general:

<input type="text" autocomplete="[section-](optional) [shipping|billing](optional) 
[home|work|mobile|fax|pager](optional) [autofill field name]">

more detailed ex:

<input type="text" name="foo" id="foo" autocomplete="section-red shipping mobile tel">

And each autocomplete values goes like this:

section-red : wrapping as a section. (named red)
shipping : shopping/billing
mobile   : home|work|mobile|fax|pager (For telephone)
tel      : [Tokens][2]

When we code it like this browser know exactly what kind of value should be populated in that field.

But browser like safari need name or id or label values should also be set right.

Support so far for autocomplete, id and name attributes for auto-completing values.

Browse  Ver OS              ID      Name    Autocomplete
Chrome  50  OS X 10.11.4    No      Yes     Yes
Opera   35  OS X 10.11.4    No      Yes     Yes
Firefox 46  OS X 10.11.4    Yes     Yes     No
Edge    25  Windows 10      No      Yes     No
Safari  9.1 OS X 10.11.4    Partial Partial Partial
Safari  9   iOS  9.3.1      Partial Partial Partial

There are more things at play here. I strongly recommend this blog I referred.

0

I've found that something like this works, but I consider this a very ugly solution, since it depends on the actual displayed text between the label tags:

<html>
  <head>
    <title>AutoFill test</title>
  </head>
  <body>
    <h1>AutoFill test</h1>
    <h2>revision 4</h2>

    <form action="#">
      <input type="text" name="cardNumber" id="id1"> <label for="id1">Number</label><br>
      <input type="text" name="cardName" id="id2"> <label for="id2">Name on card</label><br>
      <label>Expiration date</label>
      <input type="text" name="expirationMonth" id="id3" maxlength="2">
      <input type="text" name="expirationYear" id="id4" maxlength="2"><br>
      <input type="text" name="csc" id="5"> <label for="id5">CSC</label><br>
    </form>
  </body>
</html>

I am not entirely sure, but I think, that name parameters are not important.

2
  • 1
    Yeah you are on the right track, but the name parameters are important, though there are more right variation. I think the key here is that the form have to be accessed over https with a valid not self signed certificate. Commented Nov 3, 2014 at 8:55
  • HTTPS is important, indeed. But I tried to change cardName to yyy, and it worked. (Did not try to manipulate the others.)
    – gklka
    Commented Nov 3, 2014 at 14:49
0

This is now all broken after upgrading to iOS 8.1.3 this morning. When on iOS 8.1.2 all of the above worked just fine - now the keyboard option to scan credit card simply does not appear. Here's my code, which did work yesterday on iOS 8.1.2 and does not work today on iOS 8.1.3:

<html>
<head>
<title>Scan credit card using iOS 8</title>
<style type="text/css">
  input {height:1.5em;width:95%}
  input[type="number"] {font-size: 2.5em}
  body {background-color:lightgray;font-size: 3em;font-family: sans-serif;}
  #purchase {font-size: 2em;font-weight: bold;height:1.2em}
</style>
</head>
<body>
<form action="https://yoursite.com/credit-card-purchase" method="POST">
Credit Card Number 1<br />
<input  type="number" autocomplete="cc-number" name="cardNumber" id="cardNumber" value="" placeholder="*** **** *** ****" />
<br />
Expiry month <br /> 
<input type="number"  name="expirationMonth" id="cardExpirationMonth" />
<br />
Expiry year <br />
<input type="number" name="expirationYear" id="cardExpirationYear" />
<br />
<br />
<input type="submit" value="Purchase" id="purchase">
</form>
</head>
</html>
2
  • Interestingly, it should be noted that the SSL certificate I have on my domain is a 128bit TLS 1.2 and does not have a public audit records. I wonder if between iOS 8.1.2 and iOS 8.1.3 Apple of increased the SSL cert encryption threshold? e.g. to 256bit? Commented Feb 20, 2015 at 10:21
  • 1
    Problem resolved. It looks like between iOS 8.1 and 8.1.3 the valid input type for a form field has changed from "number", as I had it before, to "tel" which is what I've changed it to now. With type set to "tel" the scan credit option now appears again. When I change the field type back to number the scan option doesn't appear. Commented Feb 20, 2015 at 11:58
0

Even after using the autocomplete and ID methods described above, I had a label at the top of my page with the value Credit / Debit / Gift Card that prevented iOS from offering the Scan CC option. I ended up adding this label above my CC number field to trick iOS into offering the Scan CC option:

<label style="opacity:0.01;color:#FFF;font-size:2pt;">Card Number</label>

Opacity of 0, or a font-size of 1pt prevents iOS from offering the option.

Not the answer you're looking for? Browse other questions tagged or ask your own question.