Skip to main content

Class GetDepositBatchSummaryResponse


Properties

NAMETYPELENGTHDESCRIPTIONEXAMPLES
ResponseCodeStringResponse status. For a successful response, the code will be '00'.

A subset of possible response codes:
  • E51 = Session Timeout
  • E500 = Invalid Parameter


Note: There are many possible error response codes and the list will continue to grow over time. Whenever you receive a response code other than '00', your app should have a generic screen for handling errors where you can display the End-User facing text specific to the error response code provided in the LocalizedMessageText parameter below.
<ResponseCode>00</ResponseCode>
ErrorResponseTextStringIf the ResponseCode value is not '00', ErrorResponseText will be populated with the name of the response code. This is a developer/app level description and is intended to be internal facing only.<ErrorResponseText/>
LocalizedMessageTextStringIf the ResponseCode value is not '00', LocalizedMessageText will be populated with messaging associated with the specific response code. The messaging for each error response code can be customized by the Financial Institution by request. This error message is intended to be external facing within the app.<LocalizedMessageText/>
ItemCountIntegerNumber of items in the batch that have been processed on the back-end at the time of the response.

  • If the ItemCount matches your expetected total number of items, then you know that all items have been successful completed the back-end processing.
  • If ItemCount does not match your expected total number of items, you need to make another GetDepositBatchSummary call until they do. You may need to to call GetDepositBatchSummary a couple times before the ItemCount returns the expected number of items; we recommend waiting 2-5 seconds and submitting another GetDepositBatchSummary request.
<ItemCount>1</ItemCount>
OkItemCountIntegerNumber of checks in the transaction that are okay to submit within requires no further interaction with the End-User. Additional details for the check will be provided within the GetDepositItem step.<OkItemCount>0</OkItemCount>
NeedReviewItemCountIntegerNumber of checks in the batch that have Reject and/or IsConfirmable risks which require interaction with the End-User. Additional details for the check will be provided within the GetDepositItem step.<NeedReviewItemCount>1</NeedReviewItemCount>
ItemNumbersInt[]Array of item numbers that were defined in each AddDepositItem request (ItemNumber parameter) that have been processed and ready for you to proceed with the GetDepositItem step.

If the ItemNumbers parameter came back with no values, then the check(s) are still being processed and not ready for you to proceed yet; in this scenario, we recommend waiting 2-5 seconds and submitting another GetDepositBatchSummary request.

You need to continue submitting the GetDepositBatchSummary request until _ItemNumbers _ is passed back with all expected item numbers before you can proceed further with the deposit.
<ItemNumbers>
<int>1</int>
</ItemNumbers>
AmountDecimalTotal batch amount, in decimal form, as submitted by the enduser.<Amount>701.00</Amount>
UserItemCountIntegerThis has been deprecated. Will return 0<UserItemCount>0</UserItemCount>
UserAmountDecimalThis has been deprecated. Will return 0.00<UserAmount>0.00</UserAmount>
UserDescriptionStringThe description provided by the End-User (if applicable/available) as originally sent in the Description parameter from the CreateDepositBatch request.<UserDescription>Transaction 1</UserDescription>
DepositToAccountNumberIndexIntegerThe account index number for the account the End-User selected to deposit into as originally sent in the DepositToAccountNumberIndex parameter from the CreateDepositBatch request.<DepositToAccountNumberIndex>
0
</DepositToAccountNumberIndex>

Examples

<GetDepositBatchSummaryResponse>
<GetDepositBatchSummaryResult>
<ResponseCode>00</ResponseCode>
<ErrorResponseText/>
<LocalizedMessageText/>
<ItemCount>1</ItemCount>
<OkItemCount>0</OkItemCount>
<NeedReviewItemCount>1</NeedReviewItemCount>
<ItemNumbers>
<int>1</int>
</ItemNumbers>
<Amount>701.00</Amount>
<UserItemCount>0</UserItemCount>
<UserAmount>0.00</UserAmount>
<UserDescription>Transaction 1</UserDescription>
<DepositToAccountNumberIndex>0</DepositToAccountNumberIndex>
</GetDepositBatchSummaryResult>
</GetDepositBatchSummaryResponse>