Pular para o conteúdo principal

Criar Parceiro

Para criar um parceiro, você deve utilizar essa rota.

Importante

Com objetivo de atender as diretrizes dispostas na Circular 3.978/20 do Banco Central sobre os procedimentos a serem adotados para prevenção à lavagem de dinheiro e financiamento ao terrorismo é imprescindível o envio de todos os dados dispostos nessa documentação para o cadastro de sellers. Essa diretriz entrou em vigor em Fevereiro de 2024.

Líquidação Direta - Ambiente de Produção

O fluxo de criação de SubSellers na Marlim está disponível em produção, permitindo o cadastro completo de parceiros com todos os dados necessários para atender às diretrizes do Banco Central. No entanto, a liquidação direta para as contas bancárias dos SubSellers ainda está em desenvolvimento e não está disponível no momento. Para obter informações sobre o cronograma de disponibilização desta funcionalidade, entre em contato com o time da Marlim através dos nossos canais de suporte.

POSTv3/sub_sellers

Request Body Params​

AtributoTipoDescrição
business_namestringRazão Social da empresa.
social_namestringNome Fantasia da empresa.
emailstringE-mail da empresa.
documentstringCNPJ da empresa.
foundation_datestringData de fundação da empresa no formato YYYY-MM-DD.
automatic_anticipation_enabledbooleanParâmetro opcional que indica se o recebedor receberá antecipações automaticamente.
Default: true
phone_numberobjectObjeto Telefone da empresa.
phone_number[ddd]stringDDD do telefone da empresa.
phone_number[number]stringNúmero do telefone da empresa.
main_addressobjectObjeto Endereço principal da empresa.
main_address[zip_code]stringCEP do endereço da empresa.
main_address[state]stringEstado do endereço da empresa.
main_address[city]stringCidade do endereço da empresa.
main_address[neighborhood]stringBairro do endereço da empresa.
main_address[street]stringRua do endereço da empresa.
main_address[number]stringNúmero do endereço da empresa.
main_address[complementary]stringComplemento do endereço da empresa.
managing_partnerobjectObjeto Sócio administrador da empresa.
managing_partner[name]stringNome do sócio administrador.
managing_partner[document]stringCPF do sócio administrador.
managing_partner[birthdate]stringData de nascimento do sócio administrador no formato DD/MM/YYYY.
managing_partner[phone_number]objectObjeto Telefone do sócio administrador.
managing_partner[phone_number][ddd]stringDDD do telefone do sócio administrador.
managing_partner[phone_number][number]stringNúmero do telefone do sócio administrador.
managing_partner[address]objectObjeto Endereço do sócio administrador.
managing_partner[address][zip_code]stringCEP do endereço do sócio administrador.
managing_partner[address][state]stringEstado do endereço do sócio administrador.
managing_partner[address][city]stringCidade do endereço do sócio administrador.
managing_partner[address][neighborhood]stringBairro do endereço do sócio administrador.
managing_partner[address][street]stringRua do endereço do sócio administrador.
managing_partner[address][number]stringNúmero do endereço do sócio administrador.
managing_partner[address][complementary]stringComplemento do endereço do sócio administrador.
bank_accountobjectObjeto Conta bancária da empresa.
bank_account[bank]stringCódigo do banco.
bank_account[agency]stringNúmero da agência.
bank_account[agency_digit]stringDígito da agência.
bank_account[account_number]stringNúmero da conta.
bank_account[account_digit]stringDígito da conta.
bank_account[type]stringTipo da conta. Valores aceitos: checking ou savings.
bank_account[pix]objectObjeto de dados da chave Pix.
bank_account[pix][type]stringTipo de chave pix.
Valores aceitos: cpf, cnpj, email ou phone.
bank_account[pix][key]stringValor da chave Pix. Deve ser informado de acordo com o tipo de chave Pix.
Exemplo de Request Body
{
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "123456789",
  "foundation_date": "2020-01-01",
  "phone_number": {
    "ddd": "11",
    "number": "999999999"
  },
  "main_address": {
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  },
  "managing_partner": {
    "name": "Luke Skywalker",
    "document": "12345678900",
    "birthdate": "01/01/1980",
    "phone_number": {
      "ddd": "11",
      "number": "988888888"
    },
    "address": {
      "zip_code": "01234567",
      "state": "SP",
      "city": "São Paulo",
      "neighborhood": "Centro",
      "street": "Rua Jedi",
      "number": "123",
      "complementary": "Apto 45"
    }
  },
  "bank_account": {
    "bank": "001",
    "agency": "1234",
    "agency_digit": "5",
    "account_number": "123456",
    "account_digit": "7",
    "type": "checking",
    "pix": {
      "type": "email",
      "key": "contato@empresajedi.com.br"
    }
  }
}

Response Object​

AtributoTipoDescrição
statusstringStatus do parceiro. Valor padrão: pending.
sub_seller_idstringID do parceiro.
namestringNome do parceiro.
date_createddateTimeData de criação do parceiro no formato ISODateTime.
date_updateddateTimeData de atualização do parceiro no formato ISODateTime.
business_namestringRazão Social do parceiro.
social_namestringNome Fantasia do parceiro.
emailstringE-mail do parceiro.
documentstringCNPJ do parceiro.
Exemplo de Response
{
  "status": "pending",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-07-07T19:26:42.779Z",
  "date_updated": "2025-07-07T20:26:42.779Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190"
}

Error Object​

AtributoTipoDescrição
api_referencestringUrl para a documentação.
errorsarrayArray com todos os erros encontrados ao processar a requisição.
errors[][type]stringTipo de erro ocorrido.
errors[][message]stringMensagem detalhada do erro ocorrido.
Exemplo de erro
{
  "api_reference": "https://docs.api.marlim.co/sub_sellers/create",
  "errors": [
    {
      "type": "validation",
      "message": "The CNPJ provided is invalid."
    }
  ]
}
dica

O valor retornado em sub_seller_id é o ID que será usado para criar transações no formato Split Pagamento com múltiplos parceiros e também para realizar o repasse do Pix.

Exemplos​

ATENÇÃO

Os valores utilizados nos exemplos abaixo são apenas para ilustração e não devem ser usados para fazer requests nas APIs da Marlim. Em ambiente de desenvolvimento e testes, utilize dados mais próximos de uma transação real (dados de cartão e cliente). Se você utilizar valores fictícios o Antifraude pode não funcionar de forma esperada.

Request
curl -X POST "https://api.marlim.co/v3/sub_sellers" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190",
  "foundation_date": "2020-01-01",
  "phone_number": {
    "ddd": "11",
    "number": "999999999"
  },
  "main_address": {
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  },
  "managing_partner": {
    "name": "Luke Skywalker",
    "document": "12345678900",
    "birthdate": "01/01/1980",
    "phone_number": {
      "ddd": "11",
      "number": "988888888"
    },
    "address": {
      "zip_code": "01234567",
      "state": "SP",
      "city": "São Paulo",
      "neighborhood": "Centro",
      "street": "Rua Jedi",
      "number": "123",
      "complementary": "Apto 45"
    }
  },
  "bank_account": {
    "bank": "001",
    "agency": "1234",
    "agency_digit": "5",
    "account_number": "123456",
    "account_digit": "7",
    "type": "checking",
    "pix": {
      "type": "email",
      "key": "contato@empresajedi.com.br"
    }
  }
}'
Response200
{
  "status": "pending",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-08-27T15:32:46.029Z",
  "date_updated": "2025-08-27T15:32:46.029Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190"
}