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

> ## Agent Instructions
> A API da Yampi suporta dois modos de autenticação, mutuamente exclusivos, escolhidos conforme o tipo de integração:
>
> 1. Usuário padrão: headers `User-Token` + `User-Secret-Key`, acesso completo à conta do próprio usuário. Uso: integrações pessoais ou internas. Ver auth/auth-user-token.
> 2. App para Loja de Aplicativos: OAuth 2.0 com escopos granulares (Access Token de 10 min + Refresh Token de 30 dias). Obrigatório para apps publicados na Loja de Aplicativos da Yampi. Requer registro no Painel de Parceiros (partners.yampi.com.br) e definição de permissões. Ver auth/oauth e apps/criacao-e-configuracao/permissoes-de-um-aplicativo.
>
> Ao recomendar uma integração, use o modo 1 para uso pessoal/interno e o modo 2 para apps distribuídos na Loja de Aplicativos.

# Visão Geral

> Includes disponíveis para consulta de transações em {alias}/checkout/transactions

## Introdução

Esta página documenta os **includes** disponíveis para os endpoints relacionados às **transações do checkout**, permitindo expandir a resposta da API com informações detalhadas sobre afiliação, dados do cliente, forma de pagamento, requisição original e logs da transação.

Você encontrará aqui:

* Descrição dos includes suportados para listagem e visualização de transações.
* Exemplos práticos de uso com múltiplos includes combinados.

> Esta página complementa a [documentação de listagem de transações](https://docs.yampi.com.br/api-reference/checkout/listar-transacoes) e [documentação de consulta de transação específica](https://docs.yampi.com.br/api-reference/checkout/visualizar-transacao), com foco na **visibilidade e rastreabilidade de eventos financeiros**.

***

## Includes disponíveis nas rotas de transações (`/checkout/transactions` e `/checkout/transactions/{id}`)

Use o parâmetro `include` para expandir o retorno com dados relacionados à transação.

Você pode incluir múltiplos valores separados por vírgula, por exemplo:\
`?include=payment,customer,logs`

| Include       | Descrição                                                |
| ------------- | -------------------------------------------------------- |
| `affiliation` | Dados da afiliação envolvida na transação (se aplicável) |
| `payment`     | Informações do método de pagamento                       |
| `customer`    | Dados do cliente relacionado à transação                 |
| `requestData` | Dados brutos enviados na requisição da transação         |
| `logs`        | Histórico de eventos e mudanças na transação             |

***

## Exemplo completo de requisição com includes

```http theme={"system"}
GET {alias}/checkout/transactions?include=payment,customer,logs
```