Understanding deposits
Understanding deposits in the Rainforest ecosystem
Deposit
A deposit is the movement of funds to or from a Merchant. The merchant provides where they want their funds to be deposited to in merchant onboarding. Deposits are created on each US banking day, for every merchant who has funds to be deposited.
Payments in a deposit
The payments that make up a deposit are dependent on your merchant's deposit timing set per payment method type. See the deposit timing for payments guide on when payments are available for a deposit.
Deposit statuses
The deposit status
is the descriptor of the current status in the life cycle of the deposit.
Status | Description |
---|---|
PROCESSING | Deposit is processing and funds have been initiated. |
IN_REVIEW | Deposit has been flagged for risk review. |
SUCCEEDED | Deposit has completed processing and the funds were deposited to the merchant. |
FAILED | Deposit unsuccessfully attempted to process. |
Sandbox simulation
In Production, deposits are automatically processed for your merchants. Deposits will include payments that are ready to be released to your merchant based on deposit timing per payment type. In the Sandbox environment, payments and deposits do not move on an automatic schedule, which allows you to have move control over testing.
In Sandbox, you can simulate the processing of a merchant deposit via the simulate merchant deposit endpoint. Simulating a deposit will do the following:
- Transition all the merchant's payments with the status of
Processing
toSucceeded
. - Create a deposit with the status of
Processing
.
Once the payments are in the Succeeded
status, actions such as refunding can be taken on the payins.
You can also simulate the deposit status change from Processing
to Succeeded
via the simulate deposit status change endpoint. This will allow you to test all webhooks for payments and deposits that you will receive in Production.
Updated about 2 months ago