Enrol Data - Field Descriptions

The following page details each of the fields sent in the request and received in the response when using the Enrol Data endpoint.

Request Fields

The following table describes fields that can be included in the body of the request when using the Enroll Data endpoint.

FieldDescriptionMandatory?Type
customerDetailsThe object that contains details of the customer.--
customerReferenceIdAn external customer reference provided in the request.YesString
emailEmail address of the cardholder.YesString
phonePhone number of the cardholder.YesString
firstNameFirst name of the cardholder.YesString
middleNameMiddle name of the cardholder.YesString
lastNameLast name of the cardholder.YesString
nationalIdentifiersThe object that contains the national identifiers for the cardholder.--
typeIdentification type for the cardholder. For example, PASSPORT, DRIVING_LICENSE, NATIONAL_IDENTITY.YesString
valueIdentification number for the cardholder.YesString
end of nationalIdentifiers object---
billingAddressThe object that contains information on the cardholder's billing address. If Thredd holds no address information of Cardholder then this is mandatory.--
cityThe city for the cardholder's billing address.ConditionalString
stateThe state for the cardholder's billing address.ConditionalString
countryThe country for the cardholder's billing address, expressed as a 3-letter (alpha-3) country code as defined in ISO 3166-1.ConditionalString
postalCodeThe post code for the cardholder's billing address.ConditionalString
addressLine1First line of the cardholder's billing address.ConditionalString
addressLine2Second line of the cardholder's billing address.ConditionalString
addressLine3Third line of the cardholder's billing address.ConditionalString
end of billingAddress object---
end of customerDetails object---
pubTokensAn object of public tokens.--
valueThe Thredd 9 digit unique reference for a PAN.YesString
end of pubTokens object---

Response Fields

A successful response for the Enroll Data endpoint will return a 202 response.

FieldDescription
requestTraceIdA unique identifier to trace the request.