Atualizar Parceiro

Use esta rota para solicitar a atualização dos dados de um parceiro previamente cadastrado.

Atenção

A partir de 29/10/2026 todas as alterações cadastrais são revisadas pelo nosso time de risco. As alterações podem ser aprovadas ou recusadas. Enquanto a revisão não termina, os dados do parceiro permanecem como estão.

O resultado da revisão é informado somente por webhook, no webhook_url cadastrado na criação do parceiro. Guarde o update_id devolvido aqui para correlacionar o pedido com o webhook enviado pela Marlim.

PUTv3/sub_sellers/:sub_seller_id

Request Variable Path

Atributo	Tipo	Descrição
sub_seller_id	string	ID do parceiro.

cuidado

É necessário salvar o sub_seller_id que a Marlim retorna nas solicitações de criação na sua aplicação. Somente com este id será possível para prosseguir com a atualização.

Configurações de repasses

Atenção

Para enviar o parâmetro anticipation_settings é necessária a habilitação prévia pela Marlim. Entre em contato com nosso suporte para mais informações.

Os campos abaixo são opcionais e controlam o fluxo financeiro do parceiro, ou seja, como e quando ele recebe os valores das transações na sua conta bancária. Eles se aplicam tanto a parceiros Pessoa Jurídica quanto Pessoa Física.

automatic_anticipation_enabled (boolean, default true): indica se os recebíveis do parceiro são antecipados automaticamente. Quando true, as vendas no crédito são antecipadas de acordo com o prazo definido em anticipation_settings.
automatic_withdrawal (boolean, default true): indica se o saldo disponível é repassado (transferido) automaticamente para a conta bancária cadastrada do parceiro. Quando false, o saldo permanece retido na conta gráfica do parceiro até que o repasse seja solicitado manualmente.
anticipation_settings (enum, default D1): define em quantos dias úteis os recebíveis ficam disponíveis para repasse após uma transação paga. Veja o significado de cada opção na tabela abaixo. Requer habilitação prévia.

Valor	Prazo para disponibilização	Significado no fluxo financeiro
`D1`	1 útil dia após o pagamento da transação	Os recebíveis são antecipados e ficam disponíveis para repasse 1 dia após a captura da transação. É o menor prazo de recebimento.
`D2`	2 úteis dias após o pagamento da transação	Os recebíveis ficam disponíveis para repasse 2 dias úteis após a captura da transação.
`D5`	5 úteis dias após o pagamento da transação	Os recebíveis ficam disponíveis para repasse 5 dias úteis após a captura da transação.
`D7`	7 úteis dias após o pagamento da transação	Os recebíveis ficam disponíveis para repasse 7 dias úteis após a captura da transação.
`D10`	10 úteis dias após o pagamento da transação	Os recebíveis ficam disponíveis para repasse 10 dias úteis após a captura da transação.
`D15`	15 úteis dias após o pagamento da transação	Os recebíveis ficam disponíveis para repasse 15 dias úteis após a captura da transação.
`D22`	22 úteis dias após o pagamento da transação	Os recebíveis ficam disponíveis para repasse 22 dias úteis após a captura da transação.
`D30`	30 úteis dias após o pagamento da transação	Os recebíveis ficam disponíveis para repasse 30 dias úteis após a captura da transação.
`timeline`	Conforme o cronograma original dos recebíveis	Não há antecipação automática: cada parcela é disponibilizada na data natural de liquidação (fluxo parcela a parcela). Requer habilitação prévia, entre em contato com nosso suporte.

Atenção

Não é posssível atualizar o anticipation_settings para o fluxo timeline caso o parceiro já tenha sido criado com as configurações D1, D2, D5, D7, D10, D15, D22 ou D30 nem atualizar para as configurações D1, D2, D5, D7, D10, D15, D22 ou D30 caso o parceiro já tenha sido criado com o fluxo timeline.

Request Body Params

Atenção

Todos os campos do tipo string devem ser informados com caracteres alfanuméricos sem acentuação ou caracteres especiais.

Atributo	Tipo	Descrição
email	string	E-mail da empresa.
automatic_anticipation_enabled	boolean	Indica se o recebedor receberá antecipações automaticamente.
annual_revenue	int32	Receita anual estimada da empresa
website	string	Website da empresa.
anticipation_settings	enum	Configuração de antecipação. Valores aceitos: `D1`, `D2`, `D5`, `D7`, `D10`, `D15`, `D22`, `D30`, `timeline`. Default: `D1`
phone_number	object	Objeto Telefone da empresa.
phone_number[country_code]	string	Código do país do telefone da empresa (DDI), Ex: +55.
phone_number[ddd]	string	DDD do telefone da empresa.
phone_number[number]	string	Número do telefone da empresa.
main_address	object	Objeto Endereço principal da empresa.
main_address[country]	string	País do endereço da empresa, no formato sigla do país. Só serão aceitos o formato ISO 3166-1 alfa-2 (duas-letras) Ex: BR, US, UY... Máximo em caracteres: 2
main_address[zip_code]	string	CEP do endereço da empresa.
main_address[state]	string	Estado do endereço da empresa.
main_address[city]	string	Cidade do endereço da empresa.
main_address[neighborhood]	string	Bairro do endereço da empresa.
main_address[street]	string	Rua do endereço da empresa.
main_address[number]	string	Número do endereço da empresa.
main_address[complementary]	string	Complemento do endereço da empresa.
status	string	Status do parceiro. Valores aceitos: `active` e `inactive`.
simulate_status	string	*Parâmetro opcional* para simular o status do parceiro em ambiente de testes, não deve ser enviado em produção. Valores aceitos: `active`, `inactive`, `pending`, ou `refused`.
simulate_update_status	string	*Parâmetro opcional, somente em sandbox. Simula o resultado da revisão. Não envie em produção.* Valores aceitos: `approved` e `rejected`.
metadata	object	*Parâmetro opcional* com dados adicionais do parceiro. Quando enviado, deve conter `description`. Se omitido, mantém a descrição atual.
metadata[description]	string	Descrição do ramo de atividade do parceiro. Máximo de caracteres: 200.

cuidado

Restrições: Em produção, caso o status atual do parceiro seja pending, refused ou blocked, não é permitido realizar a atualização. A mudança só poderá ocorrer quando o status for diferente desses.

Em sandbox, para simular todos os status possíveis, basta informar o parâmetro simulate_status. Caso esse parâmetro não seja informado, a validação seguirá as restrições de produção.

Response Object

Atributo	Tipo	Descrição
status	string	Status atual do parceiro. Não é o status pedido nesta requisição.
sub_seller_id	string	ID do parceiro.
name	string	Nome do parceiro.
date_created	dateTime	Data de criação do parceiro no formato ISODateTime.
date_updated	dateTime	Data da última atualização já aplicada, no formato ISODateTime. Esta rota não altera esse valor.
business_name	string	Razão Social do parceiro.
social_name	string	Nome Fantasia do parceiro.
email	string	E-mail atual do parceiro. Não é o e-mail enviado no body, se ele ainda estiver em revisão.
document	string	CNPJ do parceiro.
update_review_status	string	Situação deste pedido. Nesta resposta o valor é sempre `pending`.
update_id	string	Identificador deste pedido de atualização. O webhook de revisão devolve o mesmo valor.

Exemplo de Response
{
  "status": "active",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-07-07T19:26:42.779Z",
  "date_updated": "2025-07-07T19:26:42.779Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190",
  "update_review_status": "pending",
  "update_id": "7c1e0b2a-4f3d-4a6e-9b11-2d8f0c6a1e90"
}

Webhook de revisão

O resultado da revisão será enviado para o webhook_url cadastrado na criação do parceiro, no evento sub_seller_update_reviewed.

Em sandbox, essa revisão é simulada. Sem simulate_update_status, ou com o valor approved, os dados são gravados e o webhook de aprovação é enviado alguns segundos depois. Com rejected, os dados não mudam e o webhook é o de recusa. A resposta desta rota continua pending nos dois casos. Em produção o campo não é aceito: o pedido fica pendente até a revisão do time de risco.

O header Marlim-Api-Signature identifica a Marlim. Se na criação foi informado webhook_auth_token, a requisição também leva Authorization: Bearer {webhook_auth_token}.

Campo	Aprovação	Recusa
`event`	`sub_seller_update_reviewed`	`sub_seller_update_reviewed`
`status`	`approved`	`rejected`
`update_id`	O mesmo `update_id` da resposta desta rota	O mesmo `update_id` da resposta desta rota
`reason`	String vazia	Motivo da recusa, quando houver
`message`	`Sub seller update approved.`	`Sub seller update rejected.`
`data`	Dados do parceiro já gravados depois da aprovação	Ausente

Na aprovação, data repete o formato do objeto de resposta desta rota, já com os campos novos. date_updated passa a ser o momento da aprovação. Na recusa o parceiro não muda e o body não traz data.

Se a aprovação mudar o status do parceiro, o webhook de status já documentado na criação (sub_seller_status_update) também pode ser enviado. Ele não substitui o sub_seller_update_reviewed: o resultado da revisão continua só neste evento.

Atualização aprovada
Atualização recusada

Webhook enviado à sua aplicação quando o time de risco aprova a atualização

curl -X POST "https://suaaplicacao.com.br/parceiros/webhook" \
-H "Content-Type: application/json" \ 
-H "User-Agent: Marlim/1.0.0" \ 
-H "Marlim-Api-Signature: Star98765Wars43210ANewHope1977" \
-d '{
  "event": "sub_seller_update_reviewed",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "update_id": "7c1e0b2a-4f3d-4a6e-9b11-2d8f0c6a1e90",
  "status": "approved",
  "reason": "",
  "message": "Sub seller update approved.",
  "data": {
    "status": "active",
    "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
    "name": "Empresa Jedi",
    "date_created": "2025-07-07T19:26:42.779Z",
    "date_updated": "2025-07-08T14:10:02.000Z",
    "business_name": "Empresa Jedi LTDA",
    "social_name": "Empresa Jedi",
    "email": "novo@empresajedi.com.br",
    "document": "12345678000190"
  }
}'

Webhook enviado à sua aplicação quando o time de risco recusa a atualização

curl -X POST "https://suaaplicacao.com.br/parceiros/webhook" \
-H "Content-Type: application/json" \ 
-H "User-Agent: Marlim/1.0.0" \ 
-H "Marlim-Api-Signature: Star98765Wars43210ANewHope1977" \
-d '{
  "event": "sub_seller_update_reviewed",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "update_id": "7c1e0b2a-4f3d-4a6e-9b11-2d8f0c6a1e90",
  "status": "rejected",
  "reason": "Os dados informados divergem do cadastro.",
  "message": "Sub seller update rejected."
}'

Exemplos

Atualização enviada para revisão
Parceiro não encontrado
Status inválido

Request

curl -X PUT "https://api.marlim.co/v3/sub_sellers/sub_k4m6Rw5rlQszEY7fiuRe" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "email": "novo@empresajedi.com.br",
  "automatic_anticipation_enabled": true,
  "annual_revenue": 1000000000,
  "website": "https://empresajedi.com.br",
  "phone_number": {
    "country_code": "+55",
    "ddd": "11",
    "number": "988888888"
  },
  "main_address": {
    "country": "BR",
    "zip_code": "01234567",
    "state": "SP",
    "city": "São Paulo",
    "neighborhood": "Centro",
    "street": "Rua Jedi",
    "number": "123",
    "complementary": "Sala 45"
  },
  "status": "active",
  "metadata": {
    "description": "Comercio de equipamentos"
  }
}'

Response200

{
  "status": "active",
  "sub_seller_id": "sub_k4m6Rw5rlQszEY7fiuRe",
  "name": "Empresa Jedi",
  "date_created": "2025-07-07T19:26:42.779Z",
  "date_updated": "2025-07-07T19:26:42.779Z",
  "business_name": "Empresa Jedi LTDA",
  "social_name": "Empresa Jedi",
  "email": "contato@empresajedi.com.br",
  "document": "12345678000190",
  "update_review_status": "pending",
  "update_id": "7c1e0b2a-4f3d-4a6e-9b11-2d8f0c6a1e90"
}

Request

curl -X PUT "https://api.marlim.co/v3/sub_sellers/sub_123456789" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "status": "active"
}'

Response404

{
  "errors": {
    "type": "Sub Seller with id [ sub_123456789 ] was not found."
  }
}

Request

curl -X PUT "https://api.marlim.co/v3/sub_sellers/sub_k4m6Rw5rlQszEY7fiuRe" \
-H "Content-Type: application/json" \
-H "api_key: api_key_value" \
-d '{
  "status": "invalid_status"
}'

Response400

{
  "errors": {
    "type": "validation",
    "message": "The status provided is invalid. Allowed values are: [ active ], and [ inactive ]."
  }
}

Request Variable Path​

Configurações de repasses​

Request Body Params​

Response Object​

Webhook de revisão​

Exemplos​

Request Variable Path

Configurações de repasses

Request Body Params

Response Object

Webhook de revisão

Exemplos