AddDepositItem
- Method
- Example Request
- Example Response
AddDepositItem(AddDepositItemRequest)
Required? Yes
Overview: AddDepositItem is the method used to upload the front and back check images along with the amount of the check as provided by the End-User.
Sequence Requirements: After a batch has been created by sending a CreateDepositBatch request, you can submit the AddDepositItem request.
Do not send fields as Null. All fields must be passed with a value or empty. Use basicHttpBinding, and don't use message security, but only transport level security (SSL).
For the first AddDepositItem in each new batch, a successful 00 response indicates that all back-end processing has been completed for the first item. For subsequent AddDepositItem requests within the same batch, a successful 00 response indicates the request was successful but not that back-end processing for that item has been completed.
For each subsequent AddDepositItem requests, a GetDepositBatchSummary request needs to be made to see if the *ItemCount *from the response matches with your expected total number of items submitted.
- 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.
The mobile application can handle GetDepositBatchSummary in the background while the End-User is going through the MiSnap check capture process. The purpose of this is to allow the End-User to continuously add items to the batch without having to wait for back-end processing to be complete for each item.
Parameters
| TYPE | NAME | DESCRIPTION |
|---|---|---|
| AddDepositItemRequest | request |
Returns
| TYPE | DESCRIPTION |
|---|---|
| AddDepositItemResponse |
<AddDepositItem>
<request>
<PartnerId>8257</PartnerId>
<LanguageId>9</LanguageId>
<DepositorIpAddress>203.0.113.0</DepositorIpAddress>
<DeviceIdentifier>21d182e6-10b1-48e2-8c53-1b72674836c1</DeviceIdentifier>
<LocalDateTime>2019-05-28T15:21:29.0000452-07:00</LocalDateTime>
<TimeZone>PST -7:00 America/Redwood_Shores</TimeZone>
<Attributes>
<Attribute>
<Name></Name>
<Value></Value>
</Attribute>
</Attributes>
<SessionStateId>00f4a870-6e5b-4163-86ce-b4e80acfddfb</SessionStateId>
<SessionToken>7bdb9860-dcd5-4f75-8629-61c8d18cbfed</SessionToken>
<DepositBatchId>91d8ce29-25ef-42a5-88a1-dafc9d216036</DepositBatchId>
<ItemNumber>1</ItemNumber>
<IsFirstItem>true</IsFirstItem>
<Micr></Micr>
<TenderType>1</TenderType>
<Amount>20.11</Amount>
<CheckImageCategory>1</CheckImageCategory>
<ImagePreprocessState>2</ImagePreprocessState>
<FrontBase64Image> <!-- Base64 Image --> </FrontBase64Image>
<BackBase64Image> <!-- Base64 Image --> </BackBase64Image>
</request>
</AddDepositItem>
<AddDepositItemResponse>
<AddDepositItemResult>
<ResponseCode>00</ResponseCode>
<ErrorResponseText/>
<LocalizedMessageText/>
</AddDepositItemResult>
</AddDepositItemResponse>