2.4 CARD
The CARD element describes a card linked to an ACCOUNT element.
Example
Child Element |
Description |
Occurs |
Data Type |
Required |
Constraints / Values |
---|---|---|---|---|---|
PAN |
Primary Account Number. |
1 |
<PAN> |
Yes |
See PAN |
VIRTUAL |
Indicates if the card is a physical or virtual card. |
1 |
<VIRTUAL> |
Yes |
See VIRTUAL |
PRIMARY |
Indicates whether or not this is the primary card for the account. |
1 |
<PRIMARY> |
Yes |
See PRIMARY |
CRDPRODUCT |
The Card Scheme (payment network), which is |
1 |
<CRDPRODUCT> |
Yes |
See CRDPRODUCT |
PROGRAMID |
The Co-Brand (i.e. Sub-Scheme) that the Program Manager operates. |
0-1 |
<PROGRAMID> |
Optional |
See PROGRAMID |
CUSTCODE |
This may be left blank or populated with the last 8 digits of the PAN. |
1 |
<CUSTCODE> |
Yes |
See CUSTCODE |
STATCODE |
The status of the card. |
1 |
<STATCODE> |
Yes |
See STATCODE |
EXPDATE |
The expiry date assigned when the card is created. This is either the date you specified when creating the card, or, if a date was not specified, it is based on the default Card Scheme (payment network) validity period in months (i.e., 36 months from the date of card creation). This date is embossed on the card. |
1 |
<EXPDATE> |
Yes |
See EXPDATE |
GPSEXPDATE |
The expiry date you specified on activation of the card or on card activation and load. If no expiry date is specified, this date is based on the Thredd validity period in days configured at product level (e.g., 1095 days from the date of card activation). |
1 |
<GPSEXPDATE> |
Yes |
See GPSEXPDATE |
CRDACCNO |
Account number of the card. This will be the same as the PAN. |
1 |
<CRDACCNO> |
Yes |
See CRDACCNO |
PRIMARYTOKEN |
If you are able to receive full PAN details for your cards, then this field provides the full Primary Account Number (PAN) of the card, as follows:
Note: This field will not be displayed if you do not receive full PAN or this is a Multi-FX card. |
1 |
<PRIMARYTOKEN> |
Optional |
See PRIMARYTOKEN |
CRDCURRCODE |
The 3-digit ISO currency code linked to the card. |
1 |
<CRDCURRCODE> |
Yes |
See CRDCURRCODE |
LINKEDTOKEN |
If the card is linked to another card with a different account, then this field holds the Thredd public token of the linked card. |
0-1 |
<LINKEDTOKEN> |
Optional |
See LINKEDTOKEN |
PRODUCTID |
Indicates the ID (unique numeric identifier) of the Thredd product associated with the card. |
1 |
xs:string |
Yes |
See PRODUCTID |
LASTUPDATED |
Timestamp indicating at what point the reported balance was in effect. This is also the date and time of the last transaction for the current card before the balance report was generated. |
1 |
xs:string |
Yes |
Maximum 14 characters, DateTime in the format: YYYYMMDDHHMMSS |
<ACCOUNT>
…detail ommitted…
<CARD>
<PAN>1234567812345678</PAN>
<VIRTUAL>N</VIRTUAL>
<PRIMARY>Y</PRIMARY>
<CRDPRODUCT>ABCD</CRDPRODUCT>
<PROGRAMID>FEDCBA</PROGRAMID>
<CUSTCODE></CUSTCODE>
<STATCODE>00</STATCODE>
<EXPDATE>2022-01-31</EXPDATE>
<GPSEXPDATE>2021-01-31</GPSEXPDATE>
<CRDACCNO>DEF123</CRDACCNO>
<PRIMARYTOKEN>234321042355666</PRIMARYTOKEN>
<CRDCURRCODE>GBP</CRDCURRCODE>
<LINKEDTOKEN>6543210123456789</LINKEDTOKEN>
<PRODUCTID>9001</PRODUCTID>
<LASTUPDATED>20190307045701</LASTUPDATED>
</CARD>
<CARD>
<PAN>8765432187654321</PAN>
<VIRTUAL>N</VIRTUAL>
<PRIMARY>N</PRIMARY>
<CRDPRODUCT>ABCD</CRDPRODUCT>
<PROGRAMID>FEDCBA</PROGRAMID>
<CUSTCODE></CUSTCODE>
<STATCODE>00</STATCODE>
<EXPDATE>2022-01-15</EXPDATE>
<GPSEXPDATE>2021-01-15</GPSEXPDATE>
<CRDACCNO>DEF123</CRDACCNO>
<PRIMARYTOKEN>234321042355666</PRIMARYTOKEN>
<CRDCURRCODE>GBP</CRDCURRCODE>
<LINKEDTOKEN>6543210123456789</LINKEDTOKEN>
<PRODUCTID>9001</PRODUCTID>
<LASTUPDATED>20181012162432</LASTUPDATED>
</CARD>
</ACCOUNT>