> ## Documentation Index
> Fetch the complete documentation index at: https://docs.azentech.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Simular eventos no sandbox

> Use os auxiliares públicos somente com processadores elegíveis em modo de teste.

Os auxiliares de sandbox localizam um evento pelo `processor_transaction_id`. Esse identificador aparece dentro de `transaction.events`.

**1. Crie uma transação de teste**

Use uma cobrança ou um pagamento com um processador em modo de teste que aceite os auxiliares de simulação.

**2. Leia o identificador do processador**

Copie `transaction.events[0].processor_transaction_id`. Não use `transaction.id` nesta etapa.

**3. Dispare a transição**

Use [Simular pagamento de cobrança](https://docs.azentech.io/reference/sandbox/pay.md), [Simular recebimento de pagamento](https://docs.azentech.io/reference/sandbox/receive.md) ou [Simular devolução](https://docs.azentech.io/reference/sandbox/refund.md).

**4. Confirme o webhook**

Verifique o evento recebido e consulte a transação pelo UUID da Azentech.

| Auxiliar | Evento emitido | Resposta quando altera o estado |
| - | - | - |
| `pay` | `capture` | `PAID` |
| `receive` | `transfer` | `RECEIVED` |
| `refund` | `refund` | `REFUNDED` |

As três rotas não usam autenticação no Gateway atual. Proteja o ambiente pela rede e mantenha processadores reais fora do modo de teste. O modo de teste é necessário, mas não garante que o processador aceite os auxiliares. Quando o processador não é elegível, a rota devolve o UUID do evento e não executa a simulação.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.