Open the Portico Developer Guide site
PosGateway Schema
TokenData Element
PosGateway Schema > CardDataType Complex Type : TokenData Element
Description

This is used when the card number from a previous transaction has been tokenized. This supports both multi-use and single-use tokens.

Namespace http://Hps.Exchange.PosGateway
Diagram
CVV2Status Element CVV2 Element ReaderPresent Element CardPresent Element ExpYear Element ExpMonth Element TokenValue Element All TokenData Element
Overview
TokenData

This is used when the card number from a previous transaction has been tokenized. This supports both multi-use and single-use tokens.

All
TokenValue xs:string

Multi-use or single-use token; used as a reference to a payment method for this transaction

ExpMonth optional monthType Simple Type

Card expiration month

Note: If expiration month and year are provided, they will be used for processing the transaction rather than the stored values associated with the provided token. This is for the current transaction only and will not be stored for future use.

ExpYear optional Restriction of yearType Simple Type
CardPresent optional booleanType Simple Type

Indicates whether or not the card was present at the time of the transaction

ReaderPresent optional booleanType Simple Type

Indicates whether or not a reader was present at the time of the transaction

CVV2 optional Restriction of cvv2Type Simple Type

CVV Number ("Card Verification Value"); 3 digits on VISA, MasterCard, Discover and UnionPay and 4 on American Express.

CVV numbers are also known as CSC numbers ("Card Security Code"), as well as CVV2 numbers, which are the same as CVV numbers, except that they have been generated by a 2nd generation process.

Note: This field is not used for EBT transactions.

CVV2Status optional cvv2Status Simple Type

Indicates why the CVV2 value was not provided; see the associated Type enumerations for specific values supported.

Note: This field is not used for EBT transactions.

Source
<xs:element name="TokenData" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:annotation>
    <xs:documentation>
      <p xmlns="http://Hps.Exchange.PosGateway">This is used when the card number from a previous transaction has been tokenized. This supports both multi-use and single-use tokens.</p>
    </xs:documentation>
  </xs:annotation>
  <xs:complexType>
    <xs:all>
      <xs:element name="TokenValue" type="xs:string">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Multi-use or single-use token; used as a reference to a payment method for this transaction</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="ExpMonth" type="monthType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Card expiration month</p>
            <p xmlns="http://Hps.Exchange.PosGateway" />
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> If expiration month and year are provided, they will be used for processing the transaction rather than the stored values associated with the provided token. This is for the current transaction only and will not be stored for future use.
                    </p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="ExpYear" minOccurs="0">
        <xs:simpleType>
          <xs:restriction base="yearType" />
        </xs:simpleType>
      </xs:element>
      <xs:element name="CardPresent" type="booleanType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Indicates whether or not the card was present at the time of the transaction</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="ReaderPresent" type="booleanType" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Indicates whether or not a reader was present at the time of the transaction</p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
      <xs:element name="CVV2" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">CVV Number ("Card Verification Value"); 3 digits on VISA, MasterCard, Discover and UnionPay and 4 on American Express.</p>
            <p xmlns="http://Hps.Exchange.PosGateway">CVV numbers are also known as CSC numbers ("Card Security Code"), as well as CVV2 numbers, which are the same as CVV numbers, except that they have been generated by a 2nd generation process.</p>
            <p xmlns="http://Hps.Exchange.PosGateway" />
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> This field is not used for EBT transactions.
                    </p>
          </xs:documentation>
        </xs:annotation>
        <xs:simpleType>
          <xs:restriction base="cvv2Type" />
        </xs:simpleType>
      </xs:element>
      <xs:element name="CVV2Status" type="cvv2Status" minOccurs="0">
        <xs:annotation>
          <xs:documentation>
            <p xmlns="http://Hps.Exchange.PosGateway">Indicates why the CVV2 value was not provided; see the associated Type enumerations for specific values supported.</p>
            <p xmlns="http://Hps.Exchange.PosGateway" />
            <p xmlns="http://Hps.Exchange.PosGateway">
              <strong>Note:</strong> This field is not used for EBT transactions.
                    </p>
          </xs:documentation>
        </xs:annotation>
      </xs:element>
    </xs:all>
  </xs:complexType>
</xs:element>
See Also
CardDataType Complex TypePosGateway Schema