Specifications

JSON Path	Value	Length	Description
summary
fileDate	NS	10	The date file is produced by the CLOWD9 platform DD-MM-YYYY format.	Mandatory
fileTime	NS	8	Time when the file is produced by the CLOWD9 platform HH:MM:SS format.	Mandatory
numberOfRecords	N	1-8	Defined number of card carriers (packaging) in the file.	Mandatory
transmissionReference	ANS	36	Unique ID for the file generated by CLOWD9 platform.	Mandatory
pinMailer
cardID	ANS	36	The Identifier of the card.	Mandatory
mailer
title	A	0-7	Title of the cardholder for the PIN Mailer i.e Mr, Miss, Mrs, etc.	Mandatory
firstName	AS	0-50	Forename of the cardholder for the PIN Mailer.	Mandatory
lastName	AS	0-50	Surname of the cardholder for the PIN Mailer.	Mandatory
addressLine1	ANS	0-100	First line of the delivery address.	Mandatory
addressLine2	ANS	0-100	Second line of the delivery address.	Optional
addressLine3	ANS	0-100	Third line of the delivery address.	Optional
city	ANS	0-50	City of the delivery address.	Mandatory
postcode	ANS	0-9	Postcode or Zipcode of the delivery address.
country	A	0-3	Country ISO Alpha value.	Mandatory
email	ANS	0-100	Cardholder email address.	Optional
phoneNumber	NS	0-15	Cardholder mobile number.	Optional
deliveryRef	N	0-1	Numeric value to identify the chosen delivery method. Values supported are 1, 2, 3 & 4. Value and associated delivery method will need to be agreed, for example: 1 -Standard Mail 2 -Registered Mail 3 - Direct Delivery (Courier) 4 - Special Delivery	Optional
type	N	1	Defines the PIN Mailer type. Values supported are 1, 2, 3 & 4. Value and associated delivery method will need to be agreed, for example: 1 - New PIN Mailer 2 - Renewal 3 - Replacement 4 - PIN Reminder.	Mandatory
envelopeRef	AN	0-50	Reference of the envelope to insert the PIN Mailer. Value must be agreed with the Card Manufacturer.	Optional
designRef	ANS	0-36	Identifies the card design. If supported and pre agreed ID with the Card Manufacturer.	Optional
fulfil1	ANS	0-10	Additional fulfilment parameter - possible values must be agreed with the Card Manufacturer.	Optional
fulfil2	ANS	0-10	Additional fulfilment parameter - possible values must be agreed with the Card Manufacturer.	Optional
language	A	0-2	Alpha character value (ISO 639-1) for the language to be printed on the carrier information.	Optional
pan	N	14-16	Primary Account Number associated with the card_id and PIN.	Mandatory
pinBlock	AN	16	Encrypted PIN Data via a pre-shared PBK/ZPK.	Mandatory