Pular para o conteúdo principal

Criar Parceiro

Para criar um parceiro (escolas ou qualquer outro tipo de empresa), 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.

POSTv1/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.
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.

Response Object​

AtributoTipoDescrição
statusstringStatus do parceiro. Valor padrão: pending.
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.
dica

O valor retornado em seller_id é o ID que será usado para criar transações no formato Split Pagamento com múltiplas escolas.

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ê utlizar valores fictícios o Antifraude pode não funcionar de forma esperada.

Request
curl -X POST "https://api.isaac.marlim.co/v1/sellers" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "business_name": "Escola Jedi LTDA",
  "social_name": "Escola Jedi",
  "email": "contato@escolajedi.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"
  }
}'
Response200
{
  "status": "pending",
  "seller_id": "se_k4m6Rw5rlQszEY7fiuRe",
  "name": "Escola Jedi",
  "date_created": "2025-03-30T20:20:05.722Z",
  "date_updated": "2025-03-30T20:20:05.722Z",
  "business_name": "Escola Jedi LTDA",
  "social_name": "Escola Jedi",
  "email": "contato@escolajedi.com.br",
  "document": "12345678000190"
}