---
title: "Criar vendedor"
method: POST
path: "/{alias}/checkout/sellers"
tags: ["Checkout - Vendedores"]
---

# Criar vendedor

`POST /{alias}/checkout/sellers`

## Request

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

Cria um novo vendedor associado à loja especificada pelo alias

## Path parameters

- `alias` string, required

## Request body

- SellerRequest: Representa os dados necessários para criar ou atualizar um vendedor
  - `affiliation_id` integer, nullable: ID da afiliação de pagamento em que o vendedor será cadastrado; aceita apenas afiliações do gateway Pagar.me.
  - `bank_account_id` integer, nullable: ID da conta bancária que recebe as transferências do vendedor.
  - `has_split` boolean, nullable: Indica se o vendedor participa do split de pagamento dos pedidos.
  - `transfer_enabled` boolean, required: Indica se as transferências automáticas para o vendedor estão habilitadas.
  - `active` boolean, nullable: Indica se o vendedor está ativo.
  - `name` string, required: Nome do vendedor.
  - `email` string, email, required: E-mail do vendedor, único dentro da loja.
  - `document` string, required: CPF ou CNPJ do vendedor, conforme o `document_type`, único dentro da loja.
  - `document_type` 'cpf' | 'cnpj', required: Tipo do documento informado em `document`.
  - `transfer_interval` 'daily' | 'weekly' | 'monthly', required: Periodicidade das transferências automáticas para o vendedor.
  - `transfer_day` integer, required: Dia da transferência automática, conforme o `transfer_interval`: `0` no diário, de 1 a 5 no semanal (dia da semana) e de 1 a 30 no mensal.
  - `antecipatable_volume_percentage` integer, nullable: Percentual do volume de vendas do vendedor disponível para antecipação.
  - `automatic_antecipation_enabled` boolean, nullable: Indica se a antecipação automática dos recebíveis do vendedor está habilitada.
  - `ref_code` string, required: Código de referência do vendedor definido pela loja, único dentro da loja.
  - `external_gateway_id` integer, nullable: ID do vendedor no gateway de pagamento.
  - `percentage_products` integer, required: Percentual do valor dos produtos repassado ao vendedor no split.
  - `percentage_shipping` integer, required: Percentual do valor do frete repassado ao vendedor no split.
  - `charge_processing_fee` boolean, nullable: Indica se a taxa de processamento do pagamento é descontada do valor repassado ao vendedor quando há chargeback.
  - `liable` boolean, required: Indica se o vendedor é responsável pelos chargebacks das vendas em que participa do split.

## Response `201`

Vendedor criado com sucesso

- Seller: Vendedor cadastrado para receber parte do valor dos pedidos por meio do split de pagamento.
  - `id` integer: Identificador único do vendedor.
  - `affiliation_id` integer: ID da afiliação de pagamento em que o vendedor foi cadastrado; aceita apenas afiliações do gateway Pagar.me.
  - `bank_account_id` integer: ID da conta bancária que recebe as transferências do vendedor.
  - `store_alias` string: Alias da loja à qual o vendedor pertence.
  - `has_split` boolean: Indica se o vendedor participa do split de pagamento dos pedidos.
  - `transfer_enabled` boolean, required: Indica se as transferências automáticas para o vendedor estão habilitadas.
  - `active` boolean: Indica se o vendedor está ativo.
  - `name` string, required: Nome do vendedor.
  - `email` string, required: E-mail do vendedor, único dentro da loja.
  - `document` string, required: CPF ou CNPJ do vendedor, conforme o `document_type`, único dentro da loja.
  - `document_type` string, required: Tipo do documento informado em `document` (`cpf` ou `cnpj`).
  - `transfer_interval` string, required: Periodicidade das transferências automáticas para o vendedor (`daily`, `weekly` ou `monthly`).
  - `transfer_day` string, required: Dia da transferência automática, conforme o `transfer_interval`: `0` no diário, de 1 a 5 no semanal (dia da semana) e de 1 a 30 no mensal.
  - `anticipatable_volume_percentage` integer: Percentual do volume de vendas do vendedor disponível para antecipação.
  - `automatic_anticipation_enabled` boolean: Indica se a antecipação automática dos recebíveis do vendedor está habilitada.
  - `ref_code` string, required: Código de referência do vendedor definido pela loja, único dentro da loja.
  - `external_gateway_id` string: ID do vendedor no gateway de pagamento.
  - `percentage_products` integer, required: Percentual do valor dos produtos repassado ao vendedor no split.
  - `percentage_shipping` integer, required: Percentual do valor do frete repassado ao vendedor no split.
  - `charge_processing_fee` boolean: Indica se a taxa de processamento do pagamento é descontada do valor repassado ao vendedor quando há chargeback.
  - `liable` boolean, required: Indica se o vendedor é responsável pelos chargebacks das vendas em que participa do split.

## 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/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)