Card Balance Transfer

<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 7.

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.

Optional

<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

The cardholder's date of birth. Mandatory if the value of <actMethod> is ‘1’ or <AuthType> is ‘2’ or ‘6’. Otherwise, may be supplied for informational purposes or as part of cardholder registration.

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. If provided, must be 6 digits, leading zeroes are acceptable. Leave empty if not required. Mandatory if the value of <AuthType> is ‘4’.

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

<TerminalID>

AN

1

15

Point of Sale (POS) or other terminal identifier, such as a hostname.

Conditional

<NewPAN>

AN

16

19

The new card number to where funds should be transferred. Mandatory in the request if <newToken> is not present.

Conditional

<NewToken>

AN

16

19

The public token to where funds should be transferred to. Mandatory in the request if <newPAN> is not present.

Conditional

<AvlBal>

D

1

20

The current balance on the card account. This includes all financial transactions and 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

<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

<AmtTxn>

D

1

20

The requested amount to transfer. If AmtTxn = 0, it is assumed the full card balance is requested to be transferred. If the amount is specified, this amount is returned in the response. Otherwise, the actual amount transferred (net of fees) is returned.

Mandatory

<CurrCode>

AN

3

3

3-letter ISO currency code for the currency (e.g. EUR). Must be supplied in the request if an <AmtTxn> is specified.

Conditional

<SysDate>

YYYY-MM-DD

10

10

The system processing date.

Omit

<LoadSrc>

AN

1

3

The source of the transfer  request. For transfers between Primary and Secondary cards, the value must be “68”. See Load Sources. If omitted, defaults to “14” =  “Unknown” for normal transfers, but “68” for Primary-Secondary card transfers.

Optional

<ItemID>

AN

1

20

The unique item ID for this card transfer. The ID returned is the ID relating to the ‘unload’ leg of the transfer from the source card.

Omit

<ActionCode>

AN

3

3

The action code for the response. See Action Codes.

Omit

<LoadedBy>

AN

1

30

Name of person/cashier making the transfer.

Optional

<Description>

AN**

1

150

Description of balance transfer. Will appear in <Account Enquiry> if supplied.

Optional

<FeeWaiver>

N

1

1

Indicates whether to waive any web service fee set up on Thredd. Options are:

0 = No;

1= Yes, waive all fees, on “from” and “to” card

2 = Waive the fee on the “from” card only.

3 = Waive the fee on the “to” card only.

Default is 0.

Optional

<BrnCode>

AN

8

8

Branch code (or Agent code) with which the card is associated. If supplied, it will be exported in the XML in CardLoadUnload > Card > branchcode.

Optional

<Fee>

D

1

9

Allows you to override the configured fee for specific transfers.

Optional