Sign in

v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Assets

Update banking asset

Update a banking asset using issuer and asset IDs

This endpoint generates an Asset updated event.

patch/v1/issuer/{issuer_id}/assets/{asset_id}

Path parameters

issuer_idstring required

Issuer ID. For more information, refer to issuer identification number

assetIdstring required

Image asset ID. This is the image_asset_id field returned from the Get eligible token requestors endpoint.

Headers

x-cidstring

The Correlation IDentifier field is used to link related API requests and events. The x-cid can help the Pismo engineering team track everything related to a call. You can find the x-cid field in the response header from an API endpoint call.

If this field isn't passed, one is automatically generated.

Request body

operation_type'DELETE' | 'SUSPEND' | 'RESUME' | 'CALL_CENTER_ACTIVATION' | 'CARDHOLDER_STEPUP_APP_TO_APP' | 'TOKEN_DEVICE_BIDING_APPROVE' | 'TOKEN_DEVICE_BINDING_APPROVE_BANK_APP' required

Operation type:

  • DELETE - Delete token

  • SUSPEND - Suspend token

  • RESUME - Resume suspended token

  • CALL_CENTER_ACTIVATION - Call center verification

  • CARDHOLDER_STEPUP_APP_TO_APP - App2App verification

  • TOKEN_DEVICE_BIDING_APPROVE - Device verification, approve and activate the most recently inactive device (only Visa)

  • TOKEN_DEVICE_BINDING_APPROVE_CALL_CENTER - Device verification with call center activation, approve and activate the most recently inactive device (only Visa)

  • TOKEN_DEVICE_BINDING_APPROVE_BANK_APP - Device verification with bank app approval, approve and activate the most recently inactive device (only Visa)

Note: For App2App token activation, set this field to CARDHOLDER_STEPUP_APP_TO_APP (Mastercard) and CALL_CENTER_ACTIVATION (Visa).

early_redemption_terms'yes' | 'no' | 'market'

Early redemption terms:

  • yes — Has early redemption terms
  • no — Does not have early redemption terms
  • market — Redeem at market

Example request

{
  "operation_type": "amendment",
  "early_redemption_terms": "yes",
  "additional_data": {
    "early_redemption_attributes": [
      {
        "date": "2021-02-01",
        "interest_rate": 1.09,
        "floating_rate": 1.18
      },
      {
        "date": "2021-03-01",
        "interest_rate": 100000000000001.1,
        "floating_rate": 1.15
      }
    ]
  }
}

Response

OK

asset_idstring

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,-,:].

asset_type'cdb' | 'rdb'

Asset type, cdb (certificate of deposit) or rdb (bank deposit receipt)

issuer_idstring

Issuer ID. For more information, see issuer identification number

isin_codestring

An International Securities Identification Number (ISIN) uniquely identifies a security. Its structure is defined in ISO 6166. The ISIN code is a 12-character alphanumeric code that serves for uniform identification of a security through normalization of the assigned National Number, where one exists, at trading and settlement.

registration_mode'single' | 'many'

Registration mode — single or many

issuing_datestring

Date/time when card was issued in RFC3339 format, i.e., 2019-07-03T17:23:18Z

maturity_datestring date

Deposit maturity date in YYYY-MM-DD format

created_atstring date-time

Datetime program calendar strategy was created. Format = YYYY-MM-DDTHH:MM:SS:MM.

updated_atstring date-time

Datetime program calendar strategy was updated. Format = YYYY-MM-DDTHH:MM:SS:MM

issued_unitsinteger

Number of issued units

unit_valuenumber double

Per unit value

index_type'di' | 'pre' | 'ipca'

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_ratenumber double

Index rate

status'PENDING' | 'PROCESSING' | 'CANCELLED' | 'SETTLED' | 'PROCESSED'

PENDING: Charge is scheduled and waiting for the cycle to close. PROCESSING: Cycle closing process has started and is awaiting completion. CANCELLED: Charge canceled due to link cancellation. SETTLED: Amount is zero and/or minimum_spend_to_charge has not been reached. PROCESSED: Charge was posted on the statement."

currencystring

ISO-4217 currency code.

early_redemption_terms'yes' | 'no' | 'market'

Early redemption terms:

  • yes — Has early redemption terms
  • no — Does not have early redemption terms
  • market — Redeem at market
interest_ratenumber double

Interest rate

Example response

{
  "asset_id": "6ea8094b-73ba-4737-93ad-370c27c54813",
  "asset_type": "cdb",
  "issuer_id": "98400-0-0d",
  "isin_code": "isin12341234",
  "registration_mode": "single",
  "issuing_date": "2019-07-03T17:23:18Z",
  "maturity_date": "2024-04-20",
  "created_at": "2024-09-12T16:46:16.43663522",
  "updated_at": "2024-09-12T16:46:16.43663522",
  "issued_units": 10,
  "unit_value": 65.56,
  "index_type": "pre",
  "index_rate": 2,
  "status": "PENDING",
  "currency": "USD",
  "early_redemption_terms": "market",
  "interest_rate": 2.3,
  "additional_data": {
    "early_redemption_attributes": [
      {
        "date": "2021-02-01",
        "interest_rate": 1.09,
        "floating_rate": 1.18
      },
      {
        "date": "2021-03-01",
        "interest_rate": 100000000000001.1,
        "floating_rate": 1.15
      }
    ]
  }
}