token (structure for card replacement)
In this case, the token
element replaces the card element in tokenized card
transactions or the echeck
element in Direct Debit transactions, and defines the tokenized payment card/account information.
Parent Elements:
authorization, captureGivenAuth, credit, forceCapture, sale, accountUpdate, updateSubscription, fastAccessFunding
Attributes:
None
Although not a required element, Worldpay recommends you include the expDate
element. If you converted PAN information to tokens using the registerTokenRequest
transaction, we do not have the expDate
value stored, so cannot add it to the transaction. Transactions without expDate
have a high likelihood of decline
Child Elements:
Required: cnpToken or tokenUrl (see Note below)
Although present in the schema, you can only use the tokenURL element in an Account Updater request, when requesting the Account Updater service from WPG.
Optional:
expDate, cardValidationNum, type, checkoutId
Example: token Structure with cardValidationNumber
<token>
<cnpToken>Token</cnpToken>
<expDate>Card Expiration Date</expDate>
<cardValidationNum>Card Validation Number</cardValidationNum>
<type>Method of Payment</type>
</token>
Example: token Structure with checkoutId instead of cardValidationNumber
<token>
<cnpToken>Token</cnpToken>
<expDate>Card Expiration Date</expDate>
<type>Method of Payment</type>
<checkoutId>Low Value Token for CVV</checkoutId>
</token>