---
title: "Deposit money"
method: POST
path: "/v1/interest/deposit"
tags: ["Interest engine"]
---

# Deposit money

`POST /v1/interest/deposit`

Deposit amount into the specified account, and use a previously configured interest plan to calculate applicable interest rates.

This endpoint generates the following events.
- [Interest deposit succeeded](https://developers.pismo.io/events/docs/interest-engine-interest-deposit-success-1) when deposit operation succeeds
- [Interest deposit failed](https://developers.pismo.io/events/docs/interest-engine-interest-deposit-failure-1) when deposit operation fails

The following events are applicable only to Brazil and are generated instead of the two events above when this endpoint is requested by a B3 (Brasil, Bolsa, Balcão) organization.
- [Interest registration succeeded](https://developers.pismo.io/events/docs/interest-engine-interest-registration-success-1) when deposit operation succeeds
- [Interest registration failed](https://developers.pismo.io/events/docs/interest-engine-interest-registration-failure-1) when deposit operation fails

For more information, refer to the [Interest-bearing accounts](https://developers.pismo.io/pismo-docs/docs/interest-bearing-accounts) guide.

## Headers

- `x-program-id` string, required
- `content-type` string, required
- `Authorization` string, required

## Request body

- InterestDepositRequest
  - `tracking_id` string, UUID, required — Tracking ID for the operation to ensure idempotence. Must be an alphanumeric UUID with the alphabetical characters in lowercase.
  - `account_id` string, number, required — Account ID
  - `interest_plan_id` string, UUID, required — Interest plan ID generated during the plan's creation. Must be an alphanumeric UUID with the alphabetical characters in lowercase.
  - `amount` number, double, required — Amount to be deposited
  - `value_date` string, date, required — Deposit date in YYYY-MM-DD format
  - `maturity_date` string, date, required — Deposit maturity date in YYYY-MM-DD format
  - `has_asset_registration` HasAssetRegistration — Applicable only to Brazil. Contains information required for asset registration. When provided, all three fields are **required**: `customer_name`, `customer_type`, and `document_name`.
    - `customer_name` string, required — Applicable only to Brazil. Account owner's name for the individual or corporate customer. **Required** when providing the `has_asset_registration` object.
    - `customer_type` 'NATURAL' | 'LEGAL', required — Applicable only to Brazil. Customer type: `NATURAL` is an individual. `LEGAL` is a corporation or other legal entity type. **Required** when providing the `has_asset_registration` object.
    - `document_number` string, required — Cardholder government document number. This can be from any document that identifies the cardholder such as a Tax ID, State ID, or driver's license.

## Response `200`

OK

- InterestDepositResponse
  - `tracking_id` string, UUID, required — Tracking ID for the operation to ensure idempotence. Must be an alphanumeric UUID with the alphabetical characters in lowercase.

## Other responses

- `400` — Bad request
- `401` — Access token is missing or invalid
- `404` — Not Found
- `500` — Internal server error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)