<payment:storeCreditCard>

Stores a credit card number to a bank-provided, CISP-compliant storage mechanism.

The output of the tag is the bank-provided unique token that may be used later to initiate payments with the <payment:payment> tag (see <payment:creditCardGUID>).

<payment:useProcessor> must be called before using this tag.

The credit card details are provided through a set of tags nested within this tag. The specific tags required may be processor-specific, but the minimum set of nested tags will generally be:

! <payment:cardNumber> - The credit/debit card number
! Either <payment:expirationDate> or both <payment:expirationMonth> and <payment:expirationYear>:
- ! <payment:expirationMonth> - The expiration month (1-12)
- ! <payment:expirationYear> - The expiration year (either two or four digit format)
- ! <payment:expirationDate> - The expiration date in either MM/YY or MM/YYYY format
! <payment:firstName> - The cardholder's first/given name
! <payment:lastName> - The cardholder's last/family name
! <payment:streetAddress1> - The billing street address (line 1)
! <payment:city> - The billing city
! <payment:countryCode> - The card holder's two-digit ISO 3166-1 alpha-2 country code

The complete list of possible nested tags:

! <payment:cardNumber> - The credit/debit card number
! <payment:expirationMonth> - The expiration month (1-12)
! <payment:expirationYear> - The expiration year (either two or four digit format)
! <payment:expirationDate> - The expiration date in either MM/YY or MM/YYYY format
? <payment:cardCode> - The CVV2 card security code (three or four digits)
! <payment:firstName> - The cardholder's first/given name
! <payment:lastName> - The cardholder's last/family name
? <payment:companyName> - The company name on the card
? <payment:email> - The email address of the customer
? <payment:phone> - The phone number of the customer
? <payment:fax> - The fax number of the customer
? <payment:customerId> - An application-supplied customer identifier
? <payment:customerTaxId> - The Social Security Number (SSN) or Employer Identification Number (EIN) of the customer
! <payment:streetAddress1> - The billing street address (line 1)
? <payment:streetAddress2> - The billing street address (line 2)
! <payment:city> - The billing city
? <payment:state> - The billing state/province/prefecture
? <payment:postalCode> - The billing ZIP/postal code
! <payment:countryCode> - The card holder's two-digit ISO 3166-1 alpha-2 country code
? <payment:comment> - Any user or merchant comments associated with this card

? indicates zero or one use allowed
! indicates exactly one use required

Tag Information

Tag Class:	com.newmediaworks.taglib.payment.StoreCreditCardTag
TagExtraInfo Class:	None
Body Content:	JSP
Display Name:	None

Attributes

Name	Required	Evaluation	Type	Description
cardNumber	No	Runtime	String	Provides the card number. Any non-numeric characters will be ignored. A nested <payment:cardNumber> tag will override this value.
expirationMonth	No	Runtime	byte	Provides the expiration month. Must be in the range 1 to 12. A nested <payment:expirationMonth> tag will override this value.
expirationYear	No	Runtime	short	Provides the expiration year. May be either a two-digit or four-digit year. If a two-digit year (or any number between 0 and 99), will be assumed to be in the current century. A nested <payment:expirationYear> tag will override this value.
expirationDate	No	Runtime	String	Provides the expiration month and year. Must be in the format `MM/YY` or `MM/YYYY`. Month must be in the range 1 to 12. Year may be either a two-digit or four-digit year. If a two-digit year (or any number between 0 and 99), will be assumed to be in the current century. A nested <payment:expirationDate> tag will override this value.
cardCode	No	Runtime	String	Provides the CVV2 card security code (three or four digits). A nested <payment:cardCode> tag will override this value.
firstName	No	Runtime	String	Provides a first/given name. A nested <payment:firstName> tag will override this value.
lastName	No	Runtime	String	Provides a last/family name. A nested <payment:lastName> tag will override this value.
companyName	No	Runtime	String	Provides a company name. A nested <payment:companyName> tag will override this value.
email	No	Runtime	String	Provides the email address. A nested <payment:email> tag will override this value.
phone	No	Runtime	String	Provides the phone number of the customer. A nested <payment:phone> tag will override this value.
fax	No	Runtime	String	Provides the fax number of the customer. A nested <payment:fax> tag will override this value.
customerId	No	Runtime	String	Provides an application-specific customer identifier. A nested <payment:customerId> tag will override this value.
customerTaxId	No	Runtime	String	Provides the Social Security Number (SSN) or Employer Identification Number (EIN) of the customer. A nested <payment:customerTaxId> tag will override this value.
streetAddress1	No	Runtime	String	Provides the street address (line 1). A nested <payment:streetAddress1> tag will override this value.
streetAddress2	No	Runtime	String	Provides the street address (line 2). A nested <payment:streetAddress2> tag will override this value.
city	No	Runtime	String	Provides the city. A nested <payment:city> tag will override this value.
state	No	Runtime	String	Provides the state/province/prefecture. A nested <payment:state> tag will override this value.
postalCode	No	Runtime	String	Provides the ZIP/postal code. A nested <payment:postalCode> tag will override this value.
countryCode	No	Runtime	String	Provides a two-digit ISO 3166-1 alpha-2 country code. A nested <payment:countryCode> tag will override this value.
comment	No	Runtime	String	Provides the comment. A nested <payment:comment> tag will override this value.

Variables

No Variables Defined.