---
title: "Register banking asset"
method: POST
path: "/v1/issuer/{issuer_id}/assets"
tags: ["Assets"]
---

# Register banking asset

`POST /v1/issuer/{issuer_id}/assets`

Register a banking asset with the Pismo platform. A banking asset is either a certificate of deposit or a bank receipt.

This endpoint generates an [Asset registration succeeded](https://developers.pismo.io/events/docs/assets-asset-registration-success-1) event if it succeeds or an [Asset registration failed](https://developers.pismo.io/events/docs/assets-asset-registration-failure-1) event if it doesn't.

## Path parameters

- `issuer_id` string, required

## Headers

- `x-cid` string

## Request body

- AssetRegistration
  - `asset_id` string, required — Asset ID. This ID is client-generated. It must be between 1 and 128 characters long and consist of only the characters [a-z,A-Z,0-9,-,:].
  - `registration_mode` 'single' | 'many', required — Registration mode — `single` or `many`
  - `asset_type` 'cdb' | 'rdb', required — Asset type, `cdb` (certificate of deposit) or `rdb` (bank deposit receipt)
  - `issuing_date` string, required — Date/time when card was issued in RFC3339 format, i.e., 2019-07-03T17:23:18Z
  - `maturity_date` string, date, required — Deposit maturity date in YYYY-MM-DD format
  - `issued_units` integer, required — Number of issued units
  - `unit_value` number, double, required — Per unit value
  - `index_type` 'di' | 'pre' | 'ipca', required — Index type: * `di` — DI rate is the average rate of interbank transactions carried out through interbank certificates of deposits. It is calculated based on fixed interbank deposits transactions settled within one business day. * `ipca` — The Extended National Consumer Price Index (IPCA) is the reference for the Brazilian inflation-targeting system. The Banco Central do Brasil (BCB) works to ensure that the IPCA's annual inflation is centered at the inflation target set by the National Monetary Council (CMN). The IPCA is also the price index of the National Treasury's Notes Series B (NTN-B). * `pre` — Use when there is a tax defined for the asset.
  - `index_rate` number, double, required — Index rate
  - `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.
  - `deposit_number` integer, required — Deposit number
  - `early_redemption_terms` 'yes' | 'no' | 'market', required — Early redemption terms: * `yes` — Has early redemption terms * `no` — Does not have early redemption terms * `market` — Redeem at market
  - `currency` string, required — ISO-4217 currency code.
  - `customer_name` string — Applicable only to Brazil. Account owner's name for the individual or corporate customer. **Required** when providing the `has_asset_registration` object.
  - `purchased_units` integer — Number of purchased units
  - `additional_data` AdditionalData
    - `early_redemption_attributes` EarlyRedemptionAttribute[]
      - `date` string — Redemption date, format = yyyy/mm/dd.
      - `interest_rate` number, double — Interest rate
      - `floating_rate` number, double — Floating rate
  - `external_id` string — Provider-generated unique ID for client monitoring and tracking
  - `accrual_frequency` 'DAILY' | 'MONTHLY' | 'QUARTERLY' | 'HALF_YEARLY' | 'YEARLY' | 'MATURITY' — Interest accrual frequency

## Response `202`

OK

- AssetRegistrationResponse
  - `asset_id` string, required — Asset ID. This ID is client-generated. It must be between 1 and 128 characters long and consist of only the characters [a-z,A-Z,0-9,-,:].
  - `message` string, required — Message

## 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/versions/935b62e16de4/schema)