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

# Conversões (CLI)

> Comandos de ingestão, atribuição, criação manual, anulação, auditoria e jornada de conversões.

O grupo `conversions` gerencia [conversões](/docs/conceitos/conversoes-e-fraude): ingestão server-to-server, [atribuição](/docs/conceitos/atribuicao) ao afiliado, criação manual, anulação e trilhas de auditoria/jornada. Para o fluxo de integração completo, veja o [guia S2S](/docs/guias/conversoes-server-to-server).

## Ingestão

`create` recebe os dados da conversão e ao menos um identificador de matching: `clickId`, `visitorId`, `emailHash`, `fingerprint`, `couponCode` ou `customer.email`.

```bash theme={null}
repass conversions create --data '{
  "sourceEventId": "order_2026-0001",
  "type": "one_time_purchase",
  "amountCents": 1990,
  "customer": { "id": "cust_8842" },
  "clickId": "clk_xxx"
}'
```

```json repass conversions create --json theme={null}
{
  "attributed": true,
  "deduplicated": false,
  "replayed": false,
  "conversion": { "id": "conv_01J9Z…", "status": "pending", "amountCents": 1990, … }
}
```

## Criação manual

`create-manual` atribui diretamente a um afiliado e **exige** `justification`.

```bash theme={null}
repass conversions create-manual --data '{
  "affiliateId": "aff_xxx",
  "type": "custom",
  "amountCents": 5000,
  "customer": { "id": "cust_1" },
  "justification": "venda por telefone"
}'
```

## Leitura

```bash theme={null}
# Buscar
repass conversions get conv_xxx --json

# Listar (paginado, com filtros)
repass conversions list --program-id prog_xxx --status approved --occurred-after 2026-06-01T00:00:00Z --json
```

`conversions list` é paginado. Veja [Paginação](/docs/cli/paginacao) para `--all` e cursores.

## Anulação e auditoria

```bash theme={null}
# Anular (corpo --data: { reason })
repass conversions void conv_xxx --data '{"reason":"reembolso"}' --yes

# Trilha de auditoria completa (todos os eventos)
repass conversions audit conv_xxx --json

# Jornada do cliente (toques e distribuição de crédito) até a conversão
repass conversions journey conv_xxx --json
```

<Warning>
  `conversions void` é `destructive`: não há "revalidar" no registry. Rode `conversions get conv_xxx` e `conversions audit conv_xxx` antes para confirmar valor/afiliado e histórico. Em terminal interativo pede confirmação; fora de TTY exige `--yes` (veja [Convenções](/docs/cli/convencoes#modelo-de-risco)).
</Warning>

<Note>
  `create` exige ao menos um identificador de matching e retorna o envelope `{ attributed, deduplicated, replayed, conversion }`. Para o schema completo de cada corpo (tipos de conversão, formato de `customer`, identificadores etc.), consulte a página SDK equivalente ([Conversions](/docs/sdk/recursos/conversions)) e a [Referência da API](/docs/convencoes/ids-e-recursos). As regras de negócio estão em [Conversões e fraude](/docs/conceitos/conversoes-e-fraude) e [Atribuição](/docs/conceitos/atribuicao).
</Note>