> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar recebedores

> API SDK Documentação - Sellers

Crie recebedores para vincular em suas cobranças.

### Método

<Tabs>
  <Tab title="Node.js">
    ```typescript theme={null}
    import { Malga } from 'malga'

    const malga = new Malga({
      apiKey: '17a64c8f-a387-4682-bdd8-d280493715e0',
      clientId: 'd1d2b51a-0446-432a-b055-034518c2660e',
    })

    await malga.sellers.create({
      merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1',
      mcc: 4040,
      owner: {
        name: 'João da Silva',
        email: 'joao.silva@test.com',
        phoneNumber: '99999999999',
        birthdate: '2000-12-31',
        document: {
          number: '99999999999',
          type: 'cpf',
          country: 'BR'
        },
        address: {
          city: 'Rio de Janeiro',
          complement: 'Sala 214',
          country: 'BR',
          district: 'São Conrado',
          state: 'RJ',
          street: 'Estrada da Gávea',
          streetNumber: '696',
          zipCode: '22610002'
        }
      },
      bankAccount: {
        holderName: 'João da Silva'
        holderDocument: '99999999999',
        bank: '077'
        branchNumber: '492',
        accountNumber: '4929',
        type: 'conta_corrente'
      },
      transferPolicy: {
        transferDay: '5'
        transferEnabled: true
        transferInterval: 'monthly'
      }
    })
    ```
  </Tab>
</Tabs>

<Tabs>
  <Tab title="Response">
    ```typescript theme={null}
    {
      id: 'c1015d17-f123-499f-aaad-32e7f7812132',
      clientId: 'd1d2b51a-0446-432a-b055-034518c2660e',
      status: 'pending',
      merchantId: '8cfef0d1-73af-4bdb-b6c4-09ad3fbfc7f1',
      mcc: 4040,
      owner: {
        name: 'João da Silva',
        email: 'joao.silva@test.com',
        phoneNumber: '99999999999',
        birthdate: '2000-12-31'
        document: {
          number: '99999999999',
          type: 'cpf',
          country: 'BR'
        },
        address: {
          city: 'Rio de Janeiro',
          complement: 'Sala 214',
          country: 'BR',
          district: 'São Conrado',
          state: 'RJ',
          street: 'Estrada da Gávea',
          streetNumber: '696',
          zipCode: '22610002'
        }
      },
      bankAccount: {
        holderName: 'João da Silva'
        holderDocument: '99999999999',
        bank: '077'
        branchNumber: '492',
        accountNumber: '4929',
        type: 'conta_corrente'
      },
      transferPolicy: {
        transferDay: '5'
        transferEnabled: true
        transferInterval: 'monthly'
      },
      providers: [{
        providerType: 'SANDBOX',
        externalId: '1103976',
        externalStatus: 'active',
        externalStatusReason: 'ok',
        status: 'active',
        createdAt: '2023-12-31T16:08:39.536Z',
        updatedAt: '2023-12-31T16:08:39.536Z'
      }]
    }
    ```
  </Tab>
</Tabs>

### Parâmetros

Lista de todos os parâmetros suportados pelo método.

<ParamField path="merchantId" type="uuid" required>
  ID do Merchant que será vinculado o recebedor
</ParamField>

<ParamField path="mcc" type="number" required>
  Código de segmento do lojista no adquirente
</ParamField>

<ParamField path="owner" type="object">
  Dados do recebedor

  <Expandable title="Parâmetros do owner">
    <ParamField path="name" type="string" required>
      Nome do recebedor
    </ParamField>

    <ParamField path="email" type="string" required>
      E-mail do recebedor
    </ParamField>

    <ParamField path="phoneNumber" type="string" required>
      Telefone do recebedor
    </ParamField>

    <ParamField path="birthdate" type="string" required>
      Data de nascimento do recebedor
    </ParamField>

    <ParamField path="document" type="object" required>
      Dados do documento do recebedor

      <Expandable title="Parâmetros do document">
        <ParamField path="type" type="string" required>
          Tipo do documento
        </ParamField>

        <ParamField path="number" type="string" required>
          Número do documento
        </ParamField>

        <ParamField path="country" type="string">
          País do documento
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="address" type="object" required>
      Dados de endereço do recebedor

      <Expandable title="Parâmetros do address">
        <ParamField path="city" type="string" required>
          Cidade
        </ParamField>

        <ParamField path="country" type="string" required>
          País
        </ParamField>

        <ParamField path="district" type="string" required>
          Bairro
        </ParamField>

        <ParamField path="state" type="string" required>
          Estado
        </ParamField>

        <ParamField path="street" type="string" required>
          Nome da rua, avenida ou travessa
        </ParamField>

        <ParamField path="streetNumber" type="string" required>
          Número da rua
        </ParamField>

        <ParamField path="zipCode" type="string" required>
          Código postal
        </ParamField>

        <ParamField path="complement" type="string">
          Complemento onde se localiza o endereço, caso exista
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="business" type="object">
  Dados do estabelecimento do recebedor

  <Expandable title="Parâmetros do business">
    <ParamField path="name" type="string" required>
      Nome do estabelecimento do recebedor
    </ParamField>

    <ParamField path="email" type="string" required>
      E-mail do estabelecimento do recebedor
    </ParamField>

    <ParamField path="phoneNumber" type="string" required>
      Telefone do estabelecimento do recebedor
    </ParamField>

    <ParamField path="openingDate" type="string" required>
      Data de abertura do estabelecimento do recebedor
    </ParamField>

    <ParamField path="description" type="string" required>
      Descrição do estabelecimento do recebedor
    </ParamField>

    <ParamField path="website" type="string">
      Site do estabelecimento do recebedor
    </ParamField>

    <ParamField path="twitter" type="string">
      Twitter do estabelecimento do recebedor
    </ParamField>

    <ParamField path="facebook" type="string">
      Facebook do estabelecimento do recebedor
    </ParamField>

    <ParamField path="document" type="object" required>
      Dados do documento do estabelecimento do recebedor

      <Expandable title="Parâmetros do document">
        <ParamField path="type" type="string" required>
          Tipo do documento
        </ParamField>

        <ParamField path="number" type="string" required>
          Número do documento
        </ParamField>

        <ParamField path="country" type="string">
          País do documento
        </ParamField>
      </Expandable>
    </ParamField>

    <ParamField path="address" type="object" required>
      Dados de endereço do estabelecimento do recebedor

      <Expandable title="Parâmetros do address">
        <ParamField path="city" type="string" required>
          Cidade
        </ParamField>

        <ParamField path="country" type="string" required>
          País
        </ParamField>

        <ParamField path="district" type="string" required>
          Bairro
        </ParamField>

        <ParamField path="state" type="string" required>
          Estado
        </ParamField>

        <ParamField path="street" type="string" required>
          Nome da rua, avenida ou travessa
        </ParamField>

        <ParamField path="streetNumber" type="string" required>
          Número da rua
        </ParamField>

        <ParamField path="zipCode" type="string" required>
          Código postal
        </ParamField>

        <ParamField path="complement" type="string">
          Complemento onde se localiza o endereço, caso exista
        </ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="bankAccount" type="object" required>
  Dados da conta bancária

  <Expandable title="Parâmetros do bankAccount">
    <ParamField path="holderName" type="string" required>
      Nome do portador da conta bancária
    </ParamField>

    <ParamField path="holderType" type="string">
      Identificador de pessoa física ou jurídica

      <br />

      <br />

      Os tipos aceitos são: <code>individual</code> ou <code>company</code>
    </ParamField>

    <ParamField path="holderDocument" type="string" required>
      Documento do portador da conta bancária
    </ParamField>

    <ParamField path="bank" type="string" required>
      Código do banco
    </ParamField>

    <ParamField path="branchNumber" type="string" required>
      Número da agência bancária
    </ParamField>

    <ParamField path="branchCheckDigit" type="string">
      Código verificador da agência bancária
    </ParamField>

    <ParamField path="accountNumber" type="string" required>
      Número da conta bancária
    </ParamField>

    <ParamField path="accountCheckDigit" type="string">
      Número verificador da conta bancária
    </ParamField>

    <ParamField path="type" type="string" required>
      Tipo da conta

      <br />

      <br />

      Os tipos aceitos são: <code>conta\_corrente</code>, <code>conta\_poupanca</code>, <code>conta\_corrente\_conjunta</code> ou <code>conta\_poupanca\_conjunta</code>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="transferPolicy" type="object" required>
  Dados da política de transferência

  <Expandable title="Parâmetros do transferPolicy">
    <ParamField path="transferDay" type="string" required>
      Dia em que o parceiro será pago
    </ParamField>

    <ParamField path="transferEnabled" type="boolean" required>
      Determina se as transferências estão autorizadas a acontecer
    </ParamField>

    <ParamField path="transferInterval" type="boolean" required>
      Intervalo entre as transferências

      <br />

      <br />

      Os tipos aceitos são: <code>daily</code>, <code>weekly</code> ou <code>monthly</code>
    </ParamField>

    <ParamField path="automaticAnticipationEnabled" type="boolean">
      Determina se o recebedor receberá antecipações automaticamente
    </ParamField>

    <ParamField path="anticipatableVolumePercentage" type="string">
      Indica a porcentagem do volume passível de ser antecipado para o recebedor
    </ParamField>

    <ParamField path="automaticAnticipationType" type="string">
      Indica o tipo de antecipação automática que será configurado para a conta do recebedor
    </ParamField>

    <ParamField path="automaticAnticipationDays" type="string">
      Indica a quantidade de dias de antecipação automática
    </ParamField>

    <ParamField path="automaticAnticipation1025Delay" type="string">
      Indica a quantidade de dias que serão desconsiderados na contabilização do valor passível de ser antecipado. A contagem de dias é realizada a partir do dia da antecipação para trás
    </ParamField>
  </Expandable>
</ParamField>

<ParamField path="metadata" type="object">
  Informações adicionais passadas com chave e valor
</ParamField>