Card Balance Adjustment

<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

<TxnCode>

AN

1

2

The Transaction Code. See Transaction Codes. Default value 16.

Mandatory

<ClientCode>

AN

1

64

User ID of the customer using the service. Only applicable to systems using member logins. Returned in the response if present in the request. Note: Legacy field. Not used. Mandatory if the value of <AuthType> is ‘5’.

Conditional

<AuthType>

AN

1

1

Parameter to specify how the card is authenticated. See Authentication Methods.

Mandatory

<PAN>

AN

14

19

Card Number. Unique card identifier.

Conditional

<Track2>

AN

1

40

The card’s Track 2. Mandatory in request if <PAN> and <PublicToken> are not present or when <AuthType> is ‘7’.

Conditional

<PublicToken>

AN

1

9

The card’s public token, Mandatory in request if <PAN> and <Track2> are not present. Mandatory in the response.

Conditional

<DOB>

YYYY-MM-

DD

10

10

Date of Birth. Mandatory if value of <AuthType> is ‘2’ or ‘6’.

Conditional

<CVV>

AN

3

3

Card Verification Value The Card Verification Value (CVV) on a credit card or debit card is a 3 digit number on VISA, MasterCard and Discover branded credit and debit cards. Cardholder's are typically required to enter the CVV during any online or cardholder not present transactions. CVV numbers are also known as CSC numbers (Card Security Code), as well as CVV2 numbers, which are the same as CVV numbers, except that they have been generated by a 2nd generation process that makes them harder to guess., the 3-digit code printed on the back of the card. Mandatory if the value of <AuthType> is ‘3’.

Conditional

<AccCode>

AN

0

6

Access code or passcode for setting a code which is validated during activation (e.g. via the Thredd IVR system Interactive Voice Response System Typically a telephony-based system, where the user calls in and selects options via an automated voice prompt.). If provided, must be 6 digits; leading zeroes are acceptable. Mandatory if the value of <AuthType> is ‘4’. Leave empty if not required.

Conditional

<LastName>

AN

1

20

Cardholder's last name for authenticating the cardholder if the value of <AuthType> is ‘6’.

Conditional

<LocDate>

YYYY-MM-

DD

10

10

The local current date in year-month-date format.

Mandatory

<LocTime>

HHMMSS

6

6

The local current time, in hour-minute-second format.

Mandatory

<AmtAdjustment>

N

1

7

The amount to debit or credit the card.

Mandatory

<CurCode>

AN

3

3

In Request: the currency alpha code of <amtAdjustment>. Must match the currency of the card account.

In Response: the currency alpha code of the <avlBal> (balance) returned. Will be the currency of the card account.

Mandatory

<DebOrCred>

AN

1

2

Whether a transaction is a debit or credit.
‘-1’ = Debit; ‘1’ = Credit.

Mandatory

<Description>

AN**

1

150

Description of balance adjustment. Will appear in Card Statement (account enquiry).

Mandatory

<AvlBal>

D

1

7

The balance on the card following the adjustment. This includes all the financials received, but excludes pending authorisations.

Omit

<ForcePost>

N

1

1

Whether to force post the adjustment to the account: False = do not force posting; true = force posting.
If <forcePost> value is 1, the adjustment is posted to the account regardless of restrictions such as limits, insufficient funds or negative balance. Force posting overrides any maximum balance limit set for the card or account.

Optional

<ExtCode>

AN

1

16

External code associated with the posting.

Only supported for legacy reasons, do not use.

Optional

<SysDate>

YYYY-MM-DD

10

10

The system processing date.

Omit

<ItemID>

AN

1

20

The unique item ID returned for the adjustment.

Omit

<ActionCode>

AN

3

3

The action code for the response. See Action Codes.

Omit

<LoadedBy>

AN

1

30

Name of person or cashier making the adjustment.

Optional