---
title: "Atualizar conta bancária do recebedor"
method: PATCH
path: "/recipients/{recipient_id}/default-bank-account"
---

# Atualizar conta bancária do recebedor

`PATCH /recipients/{recipient_id}/default-bank-account`

## Request

- Base URL: `https://api.pagar.me/core/v5`
- URL: `https://api.pagar.me/core/v5/recipients/{recipient_id}/default-bank-account`
- Auth: HTTP basic

## Path parameters

- `recipient_id` string, required

## Request body

- object
  - `bank_account` object, required: Dados da conta bancária
    - `holder_name` string, required: Nome do titular da conta.
    - `holder_type` string, required: Tipo de titular. Valores possíveis são **individual** (pessoa física) ou **company** (pessoa jurídica).
    - `holder_document` string, required: Número do documento do titular da conta. Deve ser igual ao documento do recebedor.
    - `bank` string, required: Código do banco.
    - `branch_number` string, required: Número da agência.
    - `branch_check_digit` string: Código verificador da agência.
    - `account_number` string, required: Número da conta. Máximo 13 caracteres numéricos
    - `account_check_digit` string, required: Código verificador da conta.
    - `type` string, required: Tipo da conta. Valores possíveis são **checking** ou **savings**.
    - `metadata` object: Objeto chave/valor utilizado para armazenar informações adicionais sobre a conta bancária.

## Response `200`

200

- object
  - `id` string
  - `name` string
  - `email` string
  - `document` string
  - `description` string
  - `type` string
  - `status` string
  - `created_at` string
  - `updated_at` string
  - `default_bank_account` object
    - `id` string
    - `holder_name` string
    - `holder_type` string
    - `holder_document` string
    - `bank` string
    - `branch_number` string
    - `branch_check_digit` string
    - `account_number` string
    - `account_check_digit` string
    - `type` string
    - `status` string
    - `created_at` string
    - `updated_at` string
    - `metadata` object
      - `meta_key` string
  - `gateway_recipients` object[]
    - `gateway` string
    - `status` string
    - `pgid` string
    - `createdAt` string
    - `updatedAt` string
  - `metadata` object
    - `key` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ef323290c0ff`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pagar/apis/pagarme-api/changes/recipients/:recipient_id/default-bank-account/patch.md)

---

[API](https://skmtc.dev/pagar/apis/pagarme-api.md) - [All operations](https://skmtc.dev/pagar/apis/pagarme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/pagarme-api/revisions/ef323290c0ff?raw)
