> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tupana.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Actualizar cuenta bancaria

> Actualiza uno o más campos de la cuenta bancaria registrada. Solo se modifican los campos incluidos en el request. Cada destinatario tiene una sola cuenta bancaria, por eso no hace falta enviar un id de cuenta.

## ¿Para qué se usa?

Actualiza uno o más campos de la cuenta bancaria registrada para un destinatario. Solo se modifican los campos que incluís en el request.

## Qué hace

* Actualiza parcialmente los datos de la cuenta bancaria. Como cada destinatario tiene una sola cuenta, no hace falta enviar un id de cuenta en la URL.
* Para cambiar el banco podés enviar `sbif_code` (ej `"037"`) o `bank` (ID interno). Mirá la [tabla de códigos SBIF](/api-reference/payment-requests/banking-info-create#códigos-sbif-disponibles) en el endpoint de creación.

## Consideraciones importantes

### Impacto en cobros activos

Las sesiones de cobro creadas antes de actualizar la cuenta no se ven afectadas. Los nuevos depósitos van a la cuenta actualizada.


## OpenAPI

````yaml api-reference/openapi-payment-requests.json PUT /master-entities/{master_entity_id}/banking-info/
openapi: 3.0.0
info:
  title: Tupana API - Recaudación
  description: >-
    API de Cobros — Crea sesiones de pago, procesa cobros y emite DTE
    automáticamente.
  version: 1.0.0
servers:
  - url: https://api.tupana.ai/v1
    description: Servidor de producción
security:
  - apiKeyAuth: []
paths:
  /master-entities/{master_entity_id}/banking-info/:
    put:
      tags:
        - Cuenta bancaria
      summary: Actualizar cuenta bancaria
      description: >-
        Actualiza uno o más campos de la cuenta bancaria registrada. Solo se
        modifican los campos incluidos en el request. Cada destinatario tiene
        una sola cuenta bancaria, por eso no hace falta enviar un id de cuenta.
      operationId: updateBankingInfo
      parameters:
        - name: master_entity_id
          in: path
          required: true
          description: ID del destinatario (MasterEntity).
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BankingInfoUpdate'
            example:
              account_number: '9876543210'
      responses:
        '200':
          description: Cuenta bancaria actualizada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankingInfoResponse'
        '401':
          description: API key inválida o no proporcionada
        '404':
          description: Cuenta bancaria no encontrada
      security:
        - apiKeyAuth: []
components:
  schemas:
    BankingInfoUpdate:
      type: object
      description: 'Todos los campos son opcionales: solo se actualizan los enviados.'
      properties:
        sbif_code:
          type: string
          description: |-
            Código SBIF del banco (3 dígitos).

            | Código | Banco |
            |---|---|
            | `001` | Banco de Chile |
            | `009` | Banco Internacional |
            | `014` | Scotiabank Chile |
            | `016` | Banco de Crédito e Inversiones (BCI) |
            | `028` | Banco BICE |
            | `031` | HSBC Bank (Chile) |
            | `037` | Banco Santander-Chile |
            | `039` | Banco Itaú Chile |
            | `049` | Banco Security |
            | `051` | Banco Falabella |
            | `053` | Banco Ripley |
            | `055` | Banco Consorcio |
            | `059` | Banco BTG Pactual Chile |
            | `062` | Tanner Banco Digital |
          enum:
            - '001'
            - '009'
            - '014'
            - '016'
            - '028'
            - '031'
            - '037'
            - '039'
            - '049'
            - '051'
            - '053'
            - '055'
            - '059'
            - '062'
          example: '037'
        bank:
          type: integer
          example: 7
        account_type:
          type: string
          enum:
            - checking
            - savings
            - current
        account_number:
          type: string
          example: '9876543210'
        include_in_emails:
          type: boolean
    BankingInfoResponse:
      type: object
      properties:
        id:
          type: integer
          example: 456
        bank:
          type: integer
          description: ID en BD del banco.
          example: 7
        bank_detail:
          type: object
          description: Información expandida del banco.
          properties:
            id:
              type: integer
              example: 7
            name:
              type: string
              example: BANCO SANTANDER-CHILE
            sbif_code:
              type: string
              example: '037'
            additional_brands:
              type: string
              nullable: true
              example: Banefe
            is_active:
              type: boolean
              example: true
        account_type:
          type: string
          enum:
            - checking
            - savings
            - current
          example: checking
        account_type_display:
          type: string
          description: Etiqueta legible en español del tipo de cuenta.
          example: Cuenta Corriente
        account_number:
          type: string
          example: '1234567890'
        include_in_emails:
          type: boolean
          example: true
        created_at:
          type: string
          format: date-time
          example: '2026-04-06T12:00:00Z'
        updated_at:
          type: string
          format: date-time
          example: '2026-04-06T12:00:00Z'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: 'API Key para autenticación. Formato: `Api-Key YOUR-API-KEY`'

````