Update STIP Balance - Field Descriptions

The following page details each of the fields that can be used in the request and received in the response when using the Update STIP Balance endpoint.

Request Fields

The following table describes fields that can be included in the body of the request when updating the STIP balance.

FieldDescriptionMinimum LengthMaximum LengthMandatory
AvailableSTIPBalanceGPSThe new available to spend balance on the card:
Available Balance = Current Balance – Blocked Amount
120Y
CurrentSTIPBalanceGPSThe new current balance on the card. Must not be less than the available balance.120Y
CurrenceyCodeThe currency code of the adjustment. Must match the currency of the card account.33Y
BalanceSequenceIDExTThe external host balance sequence number.118Y
UpdatedByThe name of the user that made the request.130
ProcessingDateThe date the request was processed. Must be in YYYY-MM-DD format.1010
ProcessingTimeThe time the request was processed. Must be in HHMMSS format.66
RequestDateThe date the request was made. Must be in YYYY-MM-DD format.1010
RequestTimeThe time the request was made. Must be in HHMMSS format.66
TxnCodeThe Transaction Code. See Transaction Codes. Default value 16.12Y
IssCodeThredd Issuer (Program Manager) Code. Assigned by Thredd.14Y
ItemIdThe unique item ID returned for the adjustment.120N
ActionCodeThe action code for the response. See Action Codes.33N

Response Fields

The following table describes fields included in a successful response when updating the STIP balance.

FieldDescription
BalanceSequenceIDThe Thredd balance sequence returned in the response. This is updated each time Thredd updates the actual balance or blocked amount.
BalanceSequenceIDExTThe external host balance sequence number.
CurrenceyCodeThe currency code of the balance returned. Will be the currency of the card account.
TxnCodeThe Transaction Code. See Transaction Codes. Default value 16.
ItemIdThe unique item ID returned for the adjustment.
IssCodeThredd Issuer (Program Manager) Code. Assigned by Thredd.
ActionCodeThe action code for the response. See Action Codes.
ProcessingDateThe date the request was processed. Must be in YYYY-MM-DD format.
ProcessingTimeThe time the request was processed. Must be in HHMMSS format.