Web Integration Guide

Local Navigation

Documentazione sui prodotti  >  Documentazione per gli sviluppatori  >  BlackBerry Wallet  >  Web Integration Guide BlackBerry Wallet - 1.2.1

Data elements

Credit card

HTML sample: Credit card data elements

When a user saves credit card information in the BlackBerry® Wallet, the BlackBerry Wallet checks the format of the credit card number and the CVV to verify that the format adheres to the specifications for that credit card type. This check does not verify that the credit card is valid. Web developers can add their own credit card verification when creating web pages.

Data element

Value of id attribute

Allowed character type and length of value attribute

Credit card type

bbwallet:creditCard:creditCardType

One of the following attributes:
  • American Express®
  • Diners Club®
  • MasterCard®
  • Visa®
  • Other

Credit card number

bbwallet:creditCard:creditCardNumberFull

numeric

Expiry month

bbwallet:creditCard:expiryMonth

numeric

Expiry year

bbwallet:creditCard:expiryYear

numeric

Card security code

bbwallet:creditCard:securityCode

numeric

Card holder first name

bbwallet:creditCard:creditCardFirstName

alphanumeric, 256 characters

Card holder last name

bbwallet:creditCard:creditCardLastName

alphanumeric, 256 characters

Card holder full name

bbwallet:creditCard:creditCardFullName

alphanumeric, 256 characters

Address 1

bbwallet:creditCard:address:address1

alphanumeric, 256 characters

Address 2

bbwallet:creditCard:address:address2

alphanumeric, 256 characters

City

bbwallet:creditCard:address:city

alphanumeric, 256 characters

State/province

bbwallet:creditCard:address:region

alphanumeric, 256 characters

Zip code

bbwallet:creditCard:address:zipCode

alphanumeric, 256 characters

Postal code

bbwallet:creditCard:address:postalcode

alphanumeric, 256 characters

Country

bbwallet:creditCard:address:country

alphanumeric, 256 characters

Full address

bbwallet:creditCard:address:fullAddress

alphanumeric, 256 characters

Phone number (area code and phone number)

bbwallet:creditCard:phoneNumber

numeric

Email address

bbwallet:creditCard:email

alphanumeric, 256 characters 

<input type="hidden" id="bbwallet:cardType:creditCard"/>
<p>Payment information</p>
<table cellspacing="10">
	<tr>
		<td align="right">Credit card type:</td>
		<td>
		<select name="card_type"  id="bbwallet:creditCard:creditCardType">
		<option value=""></option>
		<option value="mastercard">MasterCard</option>
		<option value="visa">Visa</option>
		<option value="amex">American Express</option>
		<option value="diner">Diner's Club</option>
		</select>
		</td>
	</tr>
	<tr>
		<td align="right">Credit card number:</td>
		<td><input name="card_number" id="bbwallet:creditCard:creditCardNumberFull" name="creditcard_number" value="" class="formFieldBasic" maxlength="50" type="text"></td>
	</tr>
	<tr>
		<td align="right">Expiry date:</td>
		<td>
		month: <select name="expire_month" class="formFieldBasic" id="bbwallet:creditCard:expiryMonth">
			<option value=""></option>
		  <option value="01">01</option>
		  <option value="02">02</option>
		  <option value="03">03</option>
		  <option value="04">04</option>
		  <option value="05">05</option>
		  <option value="06">06</option>
		  <option value="07">07</option>
		  <option value="08">08</option>
		  <option value="09">09</option>
		  <option value="10">10</option>
		  <option value="11">11</option>
		  <option value="12">12</option>
		</select>
		year: <select name="expire_year" class="formFieldBasic" id="bbwallet:creditCard:expiryYear">
			<option value=""></option>
		  <option value="2007">2007</option>
		  <option value="2008">2008</option>
		  <option value="2009">2009</option>
		  <option value="2010">2010</option>
		  <option value="2011">2011</option>
		  <option value="2012">2012</option>
		  <option value="2013">2013</option>
		  <option value="2014">2014</option>
		  <option value="2015">2015</option>
		  <option value="2016">2016</option>
		  <option value="2017">2017</option>
		</select>
		</td>
	</tr>
	<tr>
		<td align="right">Card security code:</td>
		<td><input id="bbwallet:creditCard:securityCode" name="creditcard_securitycode" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
</table>
<p>Billing address</p>
<table>
	<tr>
		<td align="right">Card holder's first name:</td>
		<td><input id="bbwallet:creditCard:creditCardFirstName" name="creditcard_holderfirstname" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
	<tr>
		<td align="right">Card holder's last name:</td>
		<td><input id="bbwallet:creditCard:creditCardLastName" name="creditcard_holderlastname" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
	<tr>
		<td align="right">Address:</td>
		<td><input id="bbwallet:creditCard:address:fullAddress" name="creditcard_fulladdress" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>	
	<tr>
		<td align="right">City:</td>
		<td><input id="bbwallet:creditCard:address:city" name="creditcard_city" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
	<tr>
		<td align="right">State:</td>
		<td><input id="bbwallet:creditCard:address:region" name="creditcard_state" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
	<tr>
		<td align="right">Postal code:</td>
		<td><input id="bbwallet:creditCard:address:postalcode" name="creditcard_postalcode" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
</table>

Gift card

HTML sample: Gift card data elements

Data element

Value of id attribute

Allowed character type and length of value attribute

Vendor

bbwallet:giftCard:vendor

alphanumeric, 256 characters

Gift card number

bbwallet:giftCard:giftCardNumber

numeric, 256 characters

Card security code

bbwallet:giftCard:securityCode

numeric, 256 characters

Expiry month

bbwallet:giftCard:expiryMonth

numeric, 2 characters

Expiry year

bbwallet:giftCard:expiryYear

numeric, 4 characters

Website

bbwallet:giftCard:webSite

alphanumeric, 256 characters 

<input type="hidden" id="bbwallet:cardType:giftCard"/>
<p>Gift card</p>
<table cellspacing="10">
	<tr>
		<td align="right">Vendor:</td>
		<td><input name="giftcard_vendor" id="bbwallet:giftCard:vendor" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>
	<tr>
		<td align="right">Card number:</td>
		<td><input name="giftcard_number" id="bbwallet:giftCard:giftCardNumber" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>	
	<tr>
		<td align="right">Expiry date:</td>
		<td>
		month: <select name="expire_month" class="formFieldBasic" id="bbwallet:giftCard:expiryMonth">
			<option value=""></option>
		  <option value="01">01</option>
		  <option value="02">02</option>
		  <option value="03">03</option>
		  <option value="04">04</option>
		  <option value="05">05</option>
		  <option value="06">06</option>
		  <option value="07">07</option>
		  <option value="08">08</option>
		  <option value="09">09</option>
		  <option value="10">10</option>
		  <option value="11">11</option>
		  <option value="12">12</option>
		</select>
		year: <select name="expire_year" class="formFieldBasic" id="bbwallet:giftCard:expiryYear">
			<option value=""></option>
		  <option value="2007">2007</option>
		  <option value="2008">2008</option>
		  <option value="2009">2009</option>
		  <option value="2010">2010</option>
		  <option value="2011">2011</option>
		  <option value="2012">2012</option>
		  <option value="2013">2013</option>
		  <option value="2014">2014</option>
		  <option value="2015">2015</option>
		  <option value="2016">2016</option>
		  <option value="2017">2017</option>
		</select>
		</td>
	</tr>	
	<tr>
		<td align="right">Security code:</td>
		<td><input name="giftcard_securitycode" id="bbwallet:giftCard:securityCode" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>	
</table>

Loyalty card

HTML sample: Loyalty card data elements

Data element

Value of id attribute

Allowed character type and length of value attribute

Reward program

bbwallet:loyaltyCard:vendor

alphanumeric, 256 characters

Account number

bbwallet:loyaltyCard:membershipNumber

numeric, 256 characters

Website

bbwallet:loyaltyCard:webSite

alphanumeric, 256 characters 

<input type="hidden" id=" bbwallet:cardType:loyaltyCard"/>
<p>Loyalty card</p>
<table cellspacing="10">
	<tr>
		<td align="right">Reward program:</td>
		<td><input name="loyalty_program" id="bbwallet:loyaltyCard:vender" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>
	<tr>
		<td align="right">Membership number:</td>
		<td><input name="loyalty_membernumber" id="bbwallet:loyaltyCard:membershipNumber" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>	
</table>

Login credentials

HTML sample: Login credentials data elements

Data element

Value of id attribute

Allowed character type and length of value attribute

Web site

bbwallet:loginCredential:webSite

alphanumeric, 256 characters

User name

bbwallet:loginCredential:userName

alphanumeric, 256 characters

Password

bbwallet:loginCredential:password

alphanumeric, 256 characters

Account number

bbwallet:loginCredential:accountNumber

numeric, 256 characters 

<input type="hidden" id="bbwallet:cardType:loginCredential"/>
<p>Log in to your account</p>
<table cellspacing="10">
	<tr>
		<td align="right">Web site:</td>
		<td><input name="login_website" id="bbwallet:loginCredential:webSite" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>
	<tr>
		<td align="right">User name:</td>
		<td><input name="login_username" id="bbwallet:loginCredential:userName" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>	
	<tr>
		<td align="right">Password:</td>
		<td><input name="login_password" id="bbwallet:loginCredential:password" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>		
	<tr>
		<td align="right">Account:</td>
		<td><input name="login_acctnumber" id="bbwallet:loginCredential:accountNumber" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>		
</table>

Shipping address

HTML sample: Shipping address data elements

Data element

Value of id attribute

Allowed character type and length of value attribute

First name

bbwallet:shippingAddress:firstName

alphanumeric, 256 characters

Last name

bbwallet:shippingAddress:lastName

alphanumeric, 256 characters

Full name

bbwallet:shippingAddress:fullName

alphanumeric, 256 characters

Address line 1

bbwallet:shippingAddress:address1

alphanumeric, 256 characters

Address line 2

bbwallet:shippingAddress:address2

alphanumeric, 256 characters

City

bbwallet:shippingAddress:city

alphanumeric, 256 characters

State/province

bbwallet:shippingAddress:region

alphanumeric, 256 characters

Zip code

bbwallet:shippingAddress:zipCode

alphanumeric, 256 characters

Postal code

bbwallet:shippingAddress:postalCode

alphanumeric, 256 characters

Country

bbwallet:shippingAddress:country

alphanumeric, 256 characters

Full address

bbwallet:shippingAddress:fullAddress

alphanumeric, 256 characters

Phone number (area code and phone number)

bbwallet:shippingAddress:phoneNumber

numeric

Email address

bbwallet:shippingAddress:email

alphanumeric, 256 characters 

<input type="hidden" id="bbwallet:cardType:shippingAddress"/>
<p>Shipping address</p>
<table cellspacing="10">
	<tr>
		<td align="right">First name:</td>
		<td><input name="firstname" id="bbwallet:shippingAddress:firstName" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>
	<tr>
		<td align="right">Last name:</td>
		<td><input name="lastname" id="bbwallet:shippingAddress:lastName" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>	
	<tr>
		<td align="right">Address:</td>
		<td><input name="address" id="bbwallet:shippingAddress:address1" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>	
	<tr>
		<td align="right">Unit:</td>
		<td><input name="unit" id="bbwallet:shippingAddress:address2" value="" class="formFieldBasic" maxlength="200" type="text" ></td>
	</tr>
	<tr>
		<td align="right">City:</td>
		<td><input name="city" id="bbwallet:shippingAddress:city" value="" class="formFieldBasic" maxlength="50" type="text"></td>
	</tr>	
	<tr>
		<td align="right">State:</td>
		<td><input name="region" id="bbwallet:shippingAddress:region"  value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
	<tr>
		<td align="right">Zip code:</td>
		<td><input name="postalzip" id="bbwallet:shippingAddress:zipCode" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
</table>

Map a data element to an existing id attribute

If your web form already includes an id attribute with a value that is not the same as the BlackBerry® Wallet data element, you can map the existing value to the BlackBerry Wallet data element.

Mapping the value of the id attribute might be useful in cases when replacing the value requires changing the way the web site is validated.

  1. Add the following element and attributes to your web page: 
    <input type ="hidden" id="data_element" value="current_value" />
  2. Change the value of the id attribute to the BlackBerry Wallet data element that you want to use to populate the field.
  3. Change the value of the value attribute to the existing value of the field's id attribute.
  4. Repeat steps 1 to 3 for each id attribute value that you want to map.

HTML sample: Mapping values for id attributes

<input type="hidden" id="bbwallet:cardType:userInfo"/>
<table cellspacing="10">
	<tr>
		<td align="right">Name:</td>
		<td><input name="fullname" id="field001" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>
	<tr>
		<td align="right">Address:</td>
		<td><input name="streetnumber" id="field002" value="" class="formFieldBasic" maxlength="120" type="text" ></td>
	</tr>
	<tr>
		<td align="right">City:</td>
		<td><input name="city" id="field003" value="" class="formFieldBasic" maxlength="50" type="text"></td>
	</tr>	
	<tr>
		<td align="right">State:</td>
		<td><input name="region" id="field004"  value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
	<tr>
		<td align="right">Zip code:</td>
		<td><input name="zip" id="field005" value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>
	<tr>
		<td align="right">Email address:</td>
		<td><input name="email" id="field006"  value="" class="formFieldBasic" maxlength="75" type="text"></td>
	</tr>	
</table>
<input type ="hidden" id="bbwallet:userInfo:fullName" value="field001" />
<input type ="hidden" id="bbwallet:userInfo:fullAddress" value="field002" />
<input type ="hidden" id="bbwallet:userInfo:city" value="field003" />
<input type ="hidden" id="bbwallet:userInfo:Region" value="field004" />
<input type ="hidden" id="bbwallet:userInfo:zipCode" value="field005" />
<input type ="hidden" id="bbwallet:userInfo:email" value="field006" />
Related concepts
Related tasks
Related reference
Next topic: HTML sample: Populating fields on a web form with data from the BlackBerry Wallet
Previous topic: Data sets

Was this information helpful? Send us your comments.