> ## 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.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# July 20, 2026 - Simulação de status de recebedor no Sandbox

> Simule o ciclo de vida do recebedor no Sandbox: status inicial derivado do documento, endpoint para troca manual e webhook seller.<status>.

export const AuthorProfile = ({author}) => <div className="flex flex-row gap-3 items-center">
    {author.image && <img src={author.image} alt={author.name} className="w-10 h-10 rounded-full m-0" />}
    <div>
      <a href={author.url}>{author.name}</a>
      <br />
      <span>{author.title}</span>
    </div>
  </div>;

export const alberto = {
  name: "Alberto Martins",
  title: "Software Engineer",
  url: "https://github.com/albertomalga",
  image: "https://github.com/albertomalga.png"
};

<div className="flex flex-row gap-4">
  <AuthorProfile author={alberto} />
</div>

Agora é possível simular o ciclo de vida de um **recebedor** no ambiente de **Sandbox**, assim como já acontecia com as cobranças: o recebedor nasce com um status determinístico, você pode alterar o status manualmente e recebe o webhook `seller.<status>` a cada mudança.

## Status inicial derivado do documento

Ao criar um recebedor no Sandbox, o status inicial é derivado do **último dígito do documento**, considerando o `owner.document.number` e, na sua ausência, o `business.document.number` (nessa ordem de prioridade).

| Documento            | Status inicial |
| -------------------- | -------------- |
| Final 7              | `pending`      |
| Final 8              | `inactive`     |
| Final 9              | `failed`       |
| Qualquer outro final | `active`       |

## Troca manual de status

Um novo endpoint permite alterar manualmente o status de um recebedor no Sandbox, disparando o webhook correspondente:

`POST /v1/sellers/{id}/status`

Consulte os detalhes em [Alterar o status de um recebedor no ambiente de sandbox](/api-reference/sellers/alterar-o-status-de-um-recebedor-no-ambiente-de-sandbox) e o mapeamento completo no [Guia de teste](/documentations/welcome/testing).

<Tip>
  Features:

  1. Status inicial do recebedor derivado do documento no Sandbox
  2. Novo endpoint `POST /v1/sellers/{id}/status` para troca manual de status
  3. Webhook `seller.<status>` disparado a cada mudança (criação e troca manual)
</Tip>


## Related topics

- [Alterar status de recebedor no Sandbox](/api-reference/sellers/alterar-o-status-de-um-recebedor-no-ambiente-de-sandbox.md)
- [Guia de teste](/documentations/welcome/testing.md)
- [Webhooks v1.1](/documentations/webhooks/webhook1-1.md)
- [Pagamentos com Pix na Malga](/documentations/payment-methods/pix.md)