registerTokenRequest

The registerTokenRequest element is the parent element for the Register Token transaction. You use this transaction type when you wish to submit an account number for tokenization, but there is no associated payment transaction.

You can use this element in either Online or Batch transactions.

When submitting registerTokenRequest elements in a batchRequest, you must also include a numTokenRegistrations= attribute in the batchRequest element.

Parent Elements:

cnpOnlineRequest, batchRequest

Attributes:

Attribute Name

Type

Required?

Description

id

String

Yes

A unique identifier assigned by the presenter and mirrored back in the response.

minLength = 1 maxLength = 36

customerId

String

No

A value assigned by the merchant to identify the consumer.

minLength = N/A maxLength = 50

reportGroup

String

Yes

Required attribute defining the merchant sub-group in the user interface where this transaction displays. For more information, please refer to Coding for Report Groups.

minLength = 1 maxLength = 25

Child Elements:

Required: either accountNumber, echeckForToken, mpos, paypageRegistrationId, encryptedAccountNumber, or applepay

Optional: orderId, cardValidationNum, encryptedCardValidationNum, encryptionKeyId

The use of the cardValidationNum element in the registertokenRequest only applies when you submit an accountNumber element.