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

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

> No Sandbox, o recebedor passa a nascer com status determinístico derivado do documento e ganha um endpoint para troca manual de status, com webhook seller.<status> a cada mudança.

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>