increase-test
POST/simulations/inbound_check_deposits

Sandbox: Create an Inbound Check Deposit

Simulates an Inbound Check Deposit against your account. This imitates someone depositing a check at their bank that was issued from your account. It may or may not be associated with a Check Transfer. The resulting Inbound Check Deposit will have a status of pending, and after an hour Increase will evaluate it as we would in production and either create a Transaction or a Declined Transaction as a result. To resolve it sooner, use the simulation to accept an Inbound Check Deposit or the API to decline one.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

4 body fields
account_number_idstringrequired
The identifier of the Account Number the Inbound Check Deposit will be against.
amountintegerrequired
The check amount in cents.
check_numberstringrequired
The check number on the check to be deposited.
payee_name_analysisstringoptional
Simulate the outcome of [payee name checking](https://increase.com/documentation/positive-pay#payee-name-mismatches). Defaults to `not_evaluated`.
Allowed:name_matchesdoes_not_matchnot_evaluated

3 status codes
200Inbound Check Deposit
accepted_atstringrequired
If the Inbound Check Deposit was accepted, the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which this took place.
account_idstringrequired
The Account the check is being deposited against.
account_number_idstringrequired
The Account Number the check is being deposited against.
adjustmentsarray<InboundCheckDepositAdjustmentsElement>required
If the deposit or the return was adjusted by the sending institution, this will contain details of the adjustments.
amountintegerrequired
The deposited amount in USD cents.
automatically_resolves_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Inbound Check Deposit will be automatically resolved if it has not been actioned by then.
back_image_file_idstringrequired
The ID for the File containing the image of the back of the check.
bank_of_first_deposit_routing_numberstringrequired
The American Bankers' Association (ABA) Routing Transit Number (RTN) for the bank depositing this check. In some rare cases, this is not transmitted via Check 21 and the value will be null.
check_numberstringrequired
The check number printed on the check being deposited.
check_transfer_idstringrequired
If this deposit is for an existing Check Transfer, the identifier of that Check Transfer.
created_atstringrequired
The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the deposit was attempted.
currencystringrequired
The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the deposit.
Allowed:USD
declined_atstringrequired
If the Inbound Check Deposit was declined, the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which this took place.
declined_transaction_idstringrequired
If the deposit attempt has been rejected, the identifier of the Declined Transaction object created as a result of the failed deposit.
deposit_returnobjectrequired
If you requested a return of this deposit, this will contain details of the return.
front_image_file_idstringrequired
The ID for the File containing the image of the front of the check.
idstringrequired
The deposit's identifier.
payee_name_analysisstringrequired
Whether the details on the check match the recipient name of the check transfer. This is an optional feature, contact sales to enable.
Allowed:name_matchesdoes_not_matchnot_evaluated
statusstringrequired
The status of the Inbound Check Deposit.
Allowed:pendingaccepteddeclinedreturnedrequires_attention
transaction_idstringrequired
If the deposit attempt has been accepted, the identifier of the Transaction object created as a result of the successful deposit.
typestringrequired
A constant representing the object's type. For this resource it will always be `inbound_check_deposit`.
Allowed:inbound_check_deposit
4XXError
5XXError