---
title: "Registra uma seller"
method: POST
path: "/api/marketplace/seller"
tags: ["Marketplace"]
---

# Registra uma seller

`POST /api/marketplace/seller`

Registra um cliente no sistema de Pagamentos vinculado ao cliente que está executando a chamada da API.  

Uma *seller* é utilizada nas operações de split e identificada através do campo **ClienteId**.

- Cada CNPJ só pode ser registrado **uma única vez**, considerando a matriz.
- A ligação entre matriz e seller ocorre com base no CNPJ.
- Para movimentações e repasses, utilize sempre o **ClienteId** retornado.

### Requisição

| **Campo**              | **Tipo** | **Descrição**                                                                 | **Obrigatório** |
|------------------------|----------|------------------------------------------------------------------------------|------------------|
| Pessoa                | Texto    | Tipo de pessoa: F (Física) ou J (Jurídica) | Sim              |
| CPFCNPJ               | Texto    | CPF (11 dígitos) ou CNPJ (14 dígitos), somente números | Sim              |
| Nome                  | Texto    | Nome do seller (usado internamente) | Sim              |
| RazaoSocial           | Texto    | Razão Social ou nome completo (repete o Nome para PF) | Sim              |
| Titularidade          | Texto    | Nome exato do titular da conta conforme registro bancário | Sim              |
| NomeCurto             | Texto    | Nome curto usado em notificações (ex: SMS) | Sim              |
| Email                 | Texto    | Endereço de e-mail válido | Sim              |
| Telefone              | Texto    | Telefone com DDD no formato 00-0000-0000 | Sim              |
| Cep                   | Texto    | CEP (somente números) | Sim              |
| Logradouro            | Texto    | Endereço (rua, avenida, etc.) | Sim              |
| Complemento           | Texto    | Complemento do endereço | Não              |
| Numero                | Texto    | Número do endereço (usar "S/N" se não houver número) | Sim              |
| Bairro                | Texto    | Nome do bairro | Sim              |
| Cidade                | Texto    | Nome da cidade | Sim              |
| UF                    | Texto    | Unidade da federação (UF), ex: SP, RJ | Sim              |
| CodigoBanco           | Texto    | Código do banco (3 dígitos, conforme padrão Febraban) | Sim              |
| AgenciaConta          | Texto    | Número da agência bancária (sem dígito) | Sim              |
| DigitoAgenciaConta    | Texto    | Dígito da agência | Não              |
| NumeroConta           | Texto    | Número da conta bancária (sem dígito) | Sim              |
| DigitoNumeroConta     | Texto    | Dígito da conta bancária | Não              |

### Resposta

| **Campo**         | **Tipo** | **Descrição**                                       |
|-------------------|----------|-----------------------------------------------------|
| DetalhesErro      | Texto    | Mensagem de erro, caso o retorno seja ERRO |
| ClientId          | Texto    | GUID do seller cadastrado |
| ContaDestinoId    | Texto    | GUID da conta bancária vinculada |
| DadosAcesso       | Texto    | Credenciais de acesso (usuário e senha) geradas |

## Headers

- `Aeskey` string, required

## Request body

- BknBankPagamentosBusinessSellerPostRequest
  - `Pessoa` string, required
  - `CPFCNPJ` string, required
  - `Nome` string, required
  - `RazaoSocial` string, required
  - `Titularidade` string, required
  - `NomeCurto` string, required
  - `Email` string, required
  - `Telefone` string, required
  - `Cep` string, required
  - `Logradouro` string, required
  - `Complemento` string
  - `Numero` string, required
  - `Bairro` string, required
  - `Cidade` string, required
  - `UF` string, required
  - `CodigoBanco` string, required
  - `AgenciaConta` string, required
  - `DigitoAgenciaConta` string
  - `NumeroConta` string, required
  - `DigitoNumeroConta` string

## Response `200`

Retorno da criacao do conteudo

- BknBankPagamentosBusinessSellerResponse
  - `DetalhesErro` string
  - `ClientId` string
  - `ContaDestinoId` string
  - `DadosAcesso` string

## Other responses

- `400` — Requisição mal formatada ou parâmetros inválidos
- `409` — Conflito ao criar seller (CNPJ já existente, etc.)
- `500` — Erro interno durante o processamento

---

[API](https://skmtc.net/meuk8/apis/k8-fintech.md) · [All operations](https://skmtc.net/meuk8/apis/k8-fintech/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/meuk8/k8-fintech/revisions/14db4977f490/schema)