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>