Um `recipient` é um recebedor — isto é, um vendedor ou empresa que expõe os seus produtos dentro do seu Marketplace. Dentro do ambiente Pagar.me é atribuido um saldo a esse recebedor, de acordo com as transações que tenham sido criadas através da loja. Para isso, você precisa criar o objeto `recipient` pela API.

É através de um `recipient` que você especifica as suas regras de split, para que os valores a receber sejam automaticamente atribuídos a cada um dos sellers envolvidos na transação.

## Criando um recebedor

Vamos aprender a criar um novo recipient, e em seguida entender cada parâmetro passado. Veja este exemplo:



É possível, porém, quebrar a criação do recebedor em múltiplas etapas:



Dessa maneira é possível criar um recebedor com uma conta bancária já existente.

## Parâmetros de um recebedor

Veja a tabela a seguir para entender cada parâmetro:

PropriedadeDescrição
**bank_account** Object[Objeto contendo os dados bancários do recebedor](🔗).
**transfer_enabled** BooleanSe o recebedor está habilitado para receber transferências ou não.
**transfer_interval** StringFrequência na qual o recebedor irá ser pago. **Valores possíveis**: `daily`, `weekly`, `monthly`.
**transfer_day** IntegerDia no qual o recebedor vai ser pago. Para cada transfer_day, existe uma faixa de pagamento possível. `weekly`: 1 a 5, onde 1 é segunda-feira e 5 é sexta-feira `monthly`: 1 a 31 `daily`: 1 **OBS**: Para monthly=31 e meses com menos de 31 dias, a transferência acontece no primeiro dia útil do mês seguinte.
**automatic_anticipation_enabled** BooleanSe o recebedor está habilitado para receber automaticamente ou não o valor disponível para antecipação.
**anticipatable_volume_percentage** IntegerPorcentagem do valor passível de antecipação para este recebedor.

## Observações

Atenção

Quando o parâmetro `transfer_interval` possui o valor `daily`, não é necessário informar o parâmetro `transfer_day`

Recebedores inativos

Todos os recebedores que foram criados a mais de 60 dias, não possuem valores a receber e nos últimos 60 dias não transacionaram ou realizaram transferências terão a transferência automática desabilitada. Mesmo que esse recebedor volte a transacionar eventualmente, a transferência automática precisa ser reabilitada manualmente nesses casos.

Alterando um recebedor

Ao atrelar uma conta bancária a um recebedor, somente será possível trocar a conta se a nova tiver o mesmo número de documento (seja ele CPF ou CNPJ). Caso contrário, essa ação não é possível.

Para aprender como atualizar um recebedor, leia mais em: [Atualizando um recebedor](🔗)

### Campo register_information

O campo register_information recebe informações cadastrais do seller. Abaixo você pode conferir as especificações do campo para pessoa física e jurídica

**Campo register_information para pessoa física**

Quando o recebedor é uma pessoa física, deve-se usar o valor `individual` no campo type.


Nome do parâmetroEspecificação do parâmetro
type **obrigatório**Utilizar "individual".
document_number ** obrigatório**Número do CPF.
name **obrigatório **Nome do seller.
site_urlSite do seller.
email **obrigatório**Email do seller
mother_nameNome da mãe
birthday **obrigatório**Data de nascimento
monthly_income **obrigatório**Renda mensal (disponível em Janeiro de 2024)
professional_occupation **obrigatório**Ocupação profissional (disponível em Janeiro de 2024)
address **obrigatório**Endereço completo
phone_numbers **obrigatório**Número de telefone do seller. Deve-se informar o DDD, número e o tipo.

**Campo register_information para pessoa jurídica**

Quando o recebedor é uma pessoa jurídica, deve-se usar o valor `corporation` no campo type.


Nome do parâmetroEspecificação do parâmetro
type **obrigatório**Utilizar "corporation"
document_number **obrigatório**Número do CNPJ.
company_name **obrigatório**Nome fantasia do seller.
trading_name **obrigatório**Razão social
annual_revenue **obrigatório**Faturamento anual (disponível em Janeiro de 2024)
corporation_typeTipo da empresa
founding_dateData de fundação
cnaeClassificação Nacional das Atividades Econômicas
email **obrigatório**Email do seller
site_url **obrigatório**Site do seller.
phone_numbers **obrigatório**Número de telefone do seller. Deve-se informar o DDD, número e o tipo.
main_address **obrigatório**Endereço completo
managing_partners **obrigatório**Dados dos sócios listados neste CNPJ/Representante legal, seguir o mesmo padrão do recebedor com type individual.