---
title: "Criar conta bancária"
method: POST
path: "/{alias}/checkout/sellers/bank-accounts"
tags: ["Checkout - Contas bancárias"]
---

# Criar conta bancária

`POST /{alias}/checkout/sellers/bank-accounts`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/checkout/sellers/bank-accounts`
- Auth: API key in header `User-Token` and API key in header `User-Secret-Key`

Cria uma nova conta bancária associada a um vendedor

## Path parameters

- `alias` string, required

## Request body

- SellerBankAccountRequest: Representa os dados necessários para criar ou atualizar um conta bancária
  - `affiliation_id` integer, nullable: ID da afiliação de pagamento em que a conta será cadastrada.
  - `bank_code` string, required: Código do banco, conforme a lista em `GET {alias}/checkout/banks`.
  - `external_gateway_id` integer, required: ID da conta bancária no gateway de pagamento.
  - `agency` string, required: Número da agência bancária, sem o dígito verificador.
  - `agency_digit` string, required: Dígito verificador da agência.
  - `account` string, required: Número da conta bancária, sem o dígito verificador.
  - `account_digit` string, required: Dígito verificador da conta.
  - `document_number` string, required: CPF ou CNPJ do titular da conta, entre 11 e 18 caracteres.
  - `legal_name` string, required: Nome ou razão social do titular da conta.
  - `type` string, required: Tipo da conta (`conta_corrente`, `conta_poupanca`, `conta_corrente_conjunta` ou `conta_poupanca_conjunta`).

## Response `200`

Conta bancária criada com sucesso

- SellerBankAccount: Conta bancária que recebe as transferências de um vendedor.
  - `id` integer: Identificador único da conta bancária.
  - `affiliation_id` integer: ID da afiliação de pagamento em que a conta foi cadastrada.
  - `bank_code` string, required: Código do banco, conforme a lista em `GET {alias}/checkout/banks`.
  - `external_gateway_id` integer, required: ID da conta bancária no gateway de pagamento.
  - `agency` string, required: Número da agência bancária, sem o dígito verificador.
  - `agency_digit` string, required: Dígito verificador da agência.
  - `account` string, required: Número da conta bancária, sem o dígito verificador.
  - `account_digit` string, required: Dígito verificador da conta.
  - `document_number` string, required: CPF ou CNPJ do titular da conta.
  - `legal_name` string, required: Nome ou razão social do titular da conta.
  - `type` string, required: Tipo da conta (`conta_corrente`, `conta_poupanca`, `conta_corrente_conjunta` ou `conta_poupanca_conjunta`).

## Other responses

- `400`: Requisição inválida

## Changes

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

[Operation history](https://skmtc.dev/yampi/apis/yampi-api/changes/:alias/checkout/sellers/bank-accounts/post.md)

---

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