About this Document

This document describes the format for the Thredd Card Generation XML Interface.

The interface allows card manufacturers to accept card generation files from Thredd.

What’s Changed?

If you want to find out what's changed since the previous release, see the Document History section.

If you want to find out about the file naming convention and different file format options available, see About the Card Generation File.

To view example files, see Example Files.

To view details of the fields in the XML files, see XML Fields.

For details of field differences between file formats, see File Format and File Versions.

Refer to the table below for other documents which should be used in conjunction with this guide.

Document	Description
Cards API Website	Describes how to use the Thredd REST-based API to create cards.
Web Services Guide	Describes how to use the Thredd SOAP Web Services API to create cards.
EHI Guide	Provides details of the Thredd External Host Interface (EHI).
Smart Client Guide	Describes Smart Client, which is an administration application that can be used to view and manage cards and transactions in your program.
Thredd Portal Guide	Describes how to use Thredd Portal, the new web application for managing your cards and transactions on the Thredd Platform.

For the latest technical documentation, see the Documentation Portal.

The following ISO standard documents provide additional information on some card fields. These are available at iso.org.

Document	Description
ISO 9564-1 Specification	Specifies PIN block formats.
ISO 7813 Specification	Specifies Magnetic Stripe Data formats.
ISO 4217 Specification	Specifies currency codes (but note that Thredd may differ slightly, in cases where Visa/Mastercard differ from the ISO specification).
ISO 8583 Specification	Specifies PAN and PAN sequence number.