Conversões (CLI)

O grupo conversions gerencia conversões: ingestão server-to-server, atribuição ao afiliado, criação manual, anulação e trilhas de auditoria/jornada. Para o fluxo de integração completo, veja o guia S2S.

Ingestão

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

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

repass conversions create --json

{
  "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.

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

Leitura

# 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 para --all e cursores.

Anulação e auditoria

# 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

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

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) e a Referência da API. As regras de negócio estão em Conversões e fraude e Atribuição.

Começando

Convenções

Recursos

Conversões (CLI)

Ingestão

Criação manual

Leitura

Anulação e auditoria

​Ingestão

​Criação manual

​Leitura

​Anulação e auditoria

Ingestão

Criação manual

Leitura

Anulação e auditoria