Card Renew

<WSID>

N

1

19

Web service ID. Must be unique for every request. For details, see the FAQs.

Mandatory

<IssCode>

AN

1

4

Thredd Issuer (Program Manager) Code. Assigned by Thredd.

Mandatory

<PAN>

AN

14

19

Card Number. Mandatory if <PublicToken> is not provided.
Mandatory in response. Card number is displayed as masked (e.g., 675926******1234).

If you are PCI compliant, the full PAN can be returned. Check with your Implementation Manager.

Conditional

<PublicToken>

AN

1

9

The card’s public token. Mandatory in request if <PAN> is not present. Mandatory in the response.

Conditional

<RenewOptions>

N

1

8

See Renew Options below.

Mandatory

<ExpDate>

AN

10

10

Expiry Date in YYYY-MM-DD format; this is forced to the last day of the given month. Mandatory if <RenewOptions> is 8, 10, 12, 26 or 28.

Conditional

<NewProductID>

N

1

8

Thredd Product ID for the new card.
Mandatory if <RenewOptions> is 4, 5, 12, 20, 21 or 28.

Conditional

<SendSMS>

N

1

1

Whether an SMS is sent to the cardholder with the card's CVV. 1 = yes; 0 =No. The default is ‘0’. The SMS is configurable.

Mandatory

<MailOrSMS>

AN

1

1

The cardholder's preferred contact method. 0 = SMS; 1 = email. 2 = SMS and email. Default value is ‘0’.

Optional

<CreateImage>

N

1

1

Specifies whether to create a card image. 1= yes, 0 = No. Images are returned in the <Image> response parameter, encrypted by a pre-shared PGP encryption key.

Optional

<FeeWaiver>

N

1

1

Indicates whether to waive any web service fee set up on the system: 0 = No, 1=Yes. Default is 0.

 Optional

<ProductRef>

AN

1

50

The physical card design reference as used by the Card Manufacturer. Identifies the PRODUCT_REF field in the XML file sent to the card manufacturer.

Optional

<VirtualCardImage>

AN

1

16

The Image ID for the virtual image for the new card. You can set up Image IDs in Smart Client Smart Client is Thredd's user interface for managing your account on the Thredd Platform. You install Smart Client as a desktop application which requires a secure connection to Thredd systems in order to access your account. in the Image Master and Virtual Card Images screens.Note: If you do not provide an image ID, the default virtual card image for the product is used.

Optional

<ImageSize>

N

1

1

The size of the virtual image: 1 = 100%; 2 = 200%; 3 = 300%; 4 = 400%; 5 = 500%. Default is 1.

Optional

<DelvMethod>

AN

1

1

The delivery method for the card. Options include:

0 = Standard delivery;

1 = Registered mail;

2 = Direct delivery;

3 = Customized DelvMethod 1;

4 = Customized DelvMethod 2;

5 = Customized DelvMethod 3;

6= Customized DelvMethod 4;

7 = Customized DelvMethod 5;

Default value is 0

Optional

< CarrierType>

AN

1

30

The Carrier Product design reference as used by the Card Manufacturer. This is the letter onto which the card is attached when sent to the cardholder. Identifies the Carrier Product type of the Card Manufacturer.

Optional

<Url>

AN

1

100

This value is included in the Thredd Card Generation file, in the <QRCode> field. For example: https://www.your-e-card.com/balance/2909680989632389

For details, see the Card Generation Interface Specifications.

Optional

<CVV>

AN

3

3

New card CVV.

Omit

<ActionCode>

AN

3

3

The action code for the response. See Action Codes.

Omit

<Image>

Base 64

PGP Pretty Good Privacy (PGP) is an encryption program that provides cryptographic privacy and authentication for data communication. uses PGP for signing, encrypting, and decrypting texts, e-mails, files, directories, and whole disk partitions and to increase the security of e-mail communications.-encrypted image of the card. Requires configuration within Smart Client. Check with your Implementation Manager.

Omit

EWALLETS

If you are renewing an eWallet, the response returns an EWALLET structure.

Omit

<IDENTITY>

AN

1

9

The Thredd 16-digit public token. Mandatory in the response.

Omit

<CARDS>

See CARDS Description below.

Omit

<PAN>

AN

1

9

Card’s physical PAN.

Omit

<CRDCURRCODE>

AN

3

3

3-digit Alpha currency code.

Omit

<CRDPRODUCT>

AN

1

50

Thredd product type.

Omit

<CUSTCODE>

AN

1

25

Customer account number. Mandatory in the response if present.

Omit

<PRIMARY>

AN

1

1

Indicates if the card is the Primary card. Default value is 'Y'.

Omit

<PROGRAMID>

AN

1

50

Card’s program ID.

Omit

<STATCODE>

AN

2

2

The status code of the card. See Status Codes.

Omit

<ACCNO>

AN

1

9

Account number of the card.

Omit

<ACCTYPE>

AN

2

2

Type of card account. See Account Types.

Omit

<CURRCODE>

AN

3

3

3-letter ISO currency code for the cardholder's account (billing) currency.

Omit

<FINAMT>

D

1

20

Balance of the account, excluding blocked amount.

Omit

<BLKAMT>

D

1

20

Amount of funds blocked on the card account as a result of all outstanding authorisations. The balance amount can include up to four decimal places, depending on the currency exponent (e.g., 10.99 for EUR which has a currency exponent of 2). See Currency Codes.

Omit