> ## 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 de depósito (API Recaudación)

> Actualiza la cuenta bancaria donde Tupana deposita lo recaudado.

## ¿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 puedes enviar `sbif_code` (ej `"037"`) o `bank` (ID interno). Mira la [tabla de códigos SBIF](https://docs.tupana.ai/api-reference/v2/payment-requests/banking-info-create.md#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-v2.json PUT /master-entities/{master_entity_id}/banking-info/
openapi: 3.0.0
info:
  title: Tupana API - Recaudación (v2)
  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/v2
    description: Producción (v2)
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 (`ment_…`), el mismo `company_id` que devuelve
            `GET /v2/connections/`.
          schema:
            type: string
            example: ment_4829301923847
      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: string
          description: ID del banco (`ban2_…`).
          example: ban2_3904107090450018022
        account_type:
          type: string
          enum:
            - checking
            - savings
            - current
        account_number:
          type: string
          example: '9876543210'
        include_in_emails:
          type: boolean
    BankingInfoResponse:
      type: object
      properties:
        master_entity:
          type: string
          description: ID de la empresa dueña de la cuenta (`ment_…`).
          example: ment_4829301923847
        id:
          type: string
          description: ID de la cuenta bancaria (`bain_…`).
          example: bain_6627310984512377
        bank:
          type: string
          description: >-
            ID del banco (`ban2_…`), el mismo `id` que devuelve `GET
            /v2/banks/`. Si envías `sbif_code` no es necesario.
          example: ban2_3904107090450018022
        bank_detail:
          type: object
          description: Información expandida del banco.
          properties:
            id:
              type: string
              example: ban2_3904107090450018022
            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`'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.