element <card> (local)

Namespace:	http://schemas.microsoft.com/hs/2001/10/myWallet
Type:	cardType
Content:	complex, 3 attributes, 15 elements, elem. wildcard
Defined:	locally within myWalletType complexType in myWallet.xsd; see XML source

XML Representation Summary

<card

changeNumber	=	xsd:nonNegativeInteger
creator	=	xsd:hexBinary
id	=	xsd:string

Content:

{any}*, cat*, typeOfCard, networkBrand, affiliateBrand?, cardNumber, displayNumber, nameOnCard, description, expirationDate?, issueDate?, validFromDate?, issueNumber?, currency, billingAddress, paymentInstrumentsIssuerPuid?

</card>

Content model elements (15):

affiliateBrand (in card), billingAddress (in card), cardNumber (in card), cat (type hs:catType), currency (type currencyType), description (type hs:localizableString), displayNumber (type hs:string), expirationDate (in card), issueDate (in card), issueNumber (in card), nameOnCard (in card), networkBrand (in card), paymentInstrumentsIssuerPuid (type hs:puidType), typeOfCard (in card), validFromDate (in card)

Included in content model of elements (1):

myWallet

Annotation

This element encapsulates information associated with the card, such as payment instruments.

XML Source (see within schema source)

<xsd:element maxOccurs="unbounded" minOccurs="0" name="card" type="cardType">

<xsd:annotation>

<xsd:documentation>

This element encapsulates information associated with the card, such as payment instruments.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

Attribute Detail (all declarations; 3/3)

changeNumber

Type:	hs:changeNumberType
Use:	required
Defined:	locally within hs:standardBlueAttributeGroup attributeGroup

XML Source (see within schema source)

<xsd:attribute name="changeNumber" type="changeNumberType" use="required"/>

creator

Type:	hs:creatorType
Use:	required
Defined:	locally within hs:standardBlueAttributeGroup attributeGroup

XML Source (see within schema source)

<xsd:attribute name="creator" type="creatorType" use="required"/>

Type:	hs:idType
Use:	required
Defined:	locally within hs:standardBlueAttributeGroup attributeGroup

XML Source (see within schema source)

<xsd:attribute name="id" type="idType" use="required"/>

Content Element Detail (all declarations; 16/16)

affiliateBrand

Type:	hs:string, simple content
Defined:	locally within cardType complexType

This optional element is designed to store the affiliated brand (that is, sub-brand) or private brand for the card. Examples of affiliated brand cards include Carte Bleue (a cobranded VISA debit card used in France), NHL Platinum credit card (a cobranded MasterCard issued by MBNA), Sears, Starbucks, and so on. The .NET Wallet service will not restrict the list. The application must validate and define a list of supported cards.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="0" name="affiliateBrand" type="hs:string">

<xsd:annotation>

<xsd:documentation>

</xsd:documentation>

</xsd:annotation>

</xsd:element>

billingAddress

Type:	hs:addressType, complex content
Defined:	locally within cardType complexType

This required element contains the billing address of the card.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="billingAddress" type="hs:addressType">

<xsd:annotation>

<xsd:documentation>

This required element contains the billing address of the card.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

cardNumber

Type:	hs:string, simple content
Defined:	locally within cardType complexType

The card number is required. The following are the validation rules for listed <b>networkBrand</b> types: <ul> <li>VISA -- prefix 4, card# length 16 or 13, Luhn mod 10 check sum</li> <li>Mastercard -- prefix 51-55, card# length 16, Luhn mod 10 check sum</li> <li>American Express, prefix 34 or 37, card# length 15, Luhn mod 10 check sum</li> <li>Discover, prefix 6011, card# length 16, Luhn mod 10 check sum</li> <li>Diners Club, prefix 300-305 or 36 or 38, card# length 14, Luhn mod 10 check sum</li> <li>JCB, prefix 3, card# length 16, Luhn mod 10 check sum</li> </ul>

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="cardNumber" type="hs:string">

<xsd:annotation>

<xsd:documentation>

The card number is required. The following are the validation rules for listed

<b>networkBrand</b>

types:

<ul>

<li>

VISA -- prefix 4, card# length 16 or 13, Luhn mod 10 check sum

</li>

<li>

Mastercard -- prefix 51-55, card# length 16, Luhn mod 10 check sum

</li>

<li>

American Express, prefix 34 or 37, card# length 15, Luhn mod 10 check sum

</li>

<li>

Discover, prefix 6011, card# length 16, Luhn mod 10 check sum

</li>

<li>

Diners Club, prefix 300-305 or 36 or 38, card# length 14, Luhn mod 10 check sum

</li>

<li>

JCB, prefix 3, card# length 16, Luhn mod 10 check sum

</li>

</ul>

</xsd:documentation>

</xsd:annotation>

</xsd:element>

cat

Type:	hs:catType, empty content
Defined:	locally within cardType complexType

XML Source (see within schema source)

<xsd:element maxOccurs="unbounded" minOccurs="0" name="cat" type="hs:catType"/>

currency

Type:	currencyType, complex content
Defined:	locally within cardType complexType

This optional element contains the billing currency of this card.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="currency" type="currencyType">

<xsd:annotation>

<xsd:documentation>

This optional element contains the billing currency of this card.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

description

Type:	hs:localizableString, simple content
Defined:	locally within cardType complexType

This required element contains a short description of the card for easy reference (for example, my bank VISA, my corporate American Express, and so on).

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="description" type="hs:localizableString">

<xsd:annotation>

<xsd:documentation>

This required element contains a short description of the card for easy reference (for example, my bank VISA, my corporate American Express, and so on).

</xsd:documentation>

</xsd:annotation>

</xsd:element>

displayNumber

Type:	hs:string, simple content
Defined:	locally within cardType complexType

The last four digits of the card number are required. This will be a read-only field that is derived from the card number by the system.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="displayNumber" type="hs:string">

<xsd:annotation>

<xsd:documentation>

The last four digits of the card number are required. This will be a read-only field that is derived from the
card number by the system.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

expirationDate

Type:	xsd:dateTime, predefined, simple content
Defined:	locally within cardType complexType

This optional element contains the expiration date of a card.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="0" name="expirationDate" type="xsd:dateTime">

<xsd:annotation>

<xsd:documentation>

This optional element contains the expiration date of a card.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

issueDate

Type:	xsd:dateTime, predefined, simple content
Defined:	locally within cardType complexType

The optional element contains the date that this card was issued.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="0" name="issueDate" type="xsd:dateTime">

<xsd:annotation>

<xsd:documentation>

The optional element contains the date that this card was issued.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

issueNumber

Type:	hs:string, simple content
Defined:	locally within cardType complexType

This optional element contains the issue number of the card, which is used by some debit cards (for example, Switch).

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="0" name="issueNumber" type="hs:string">

<xsd:annotation>

<xsd:documentation>

This optional element contains the issue number of the card, which is used by some debit cards (for example, Switch).

</xsd:documentation>

</xsd:annotation>

</xsd:element>

nameOnCard

Type:	hs:localizableString, simple content
Defined:	locally within cardType complexType

The card holder's name. Mandatory.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="nameOnCard" type="hs:localizableString">

<xsd:annotation>

<xsd:documentation>

The card holder's name. Mandatory.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

networkBrand

Type:	xsd:anyURI, predefined, simple content
Defined:	locally within cardType complexType

This required element is designed to store a reference to the global or regional/national well-recognized and accepted card brand, also known as card type, such as VISA, MasterCard, American Express, Discover, Diners Club, and so on. A naming convention among applications and services ensures that data can be used across these applications and/or services. Applications can use the values defined in myWallet system document, networkBrand.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="networkBrand" type="xsd:anyURI">

<xsd:annotation>

<xsd:documentation>

</xsd:documentation>

</xsd:annotation>

</xsd:element>

paymentInstrumentsIssuerPuid

Type:	hs:puidType, simple content
Defined:	locally within cardType complexType

This optional element is intended to store the Microsoft® .NET Passport User ID (PUID) of the issuer for this card. An issuer for a card is usually a financial institution.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="0" name="paymentInstrumentsIssuerPuid" type="hs:puidType">

<xsd:annotation>

<xsd:documentation>

This optional element is intended to store the Microsoft® .NET Passport User ID (PUID) of the issuer for this card. An issuer for a card is usually a financial institution.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

typeOfCard

Type:	typeOfCardType, simple content
Defined:	locally within cardType complexType

This required element is designed to store the card type (for example, credit, debit, and so on). Valid values are defined in the enumeration list in the schema.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="1" name="typeOfCard" type="typeOfCardType">

<xsd:annotation>

<xsd:documentation>

This required element is designed to store the card type (for example, credit, debit, and so on).
Valid values are defined in the enumeration list in the schema.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

validFromDate

Type:	xsd:dateTime, predefined, simple content
Defined:	locally within cardType complexType

This optional element contains the date from which the card is valid.

XML Source (see within schema source)

<xsd:element maxOccurs="1" minOccurs="0" name="validFromDate" type="xsd:dateTime">

<xsd:annotation>

<xsd:documentation>

This optional element contains the date from which the card is valid.

</xsd:documentation>

</xsd:annotation>

</xsd:element>

{any element with non-schema namespace}

Defined:

within cardType complexType

XML Source (see within schema source)

<xsd:any maxOccurs="unbounded" minOccurs="0" namespace="##other" processContents="skip"/>