Registra uma conversão manualmente (operador)
Attributes a conversion to an explicit affiliate. A justification is required and is recorded in the emitted conversion.created event.
Authorizations
Chave de API (prefixo rstr_) enviada como Authorization: Bearer rstr_....
Body
Afiliado ao qual a conversão será atribuída explicitamente.
^aff_[0-9A-HJKMNP-TV-Z]{26}$"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Tipo da conversão. subscription_created: nova assinatura. one_time_purchase: compra avulsa. trial_converted: trial convertido em assinatura paga. upgrade: upgrade de plano. custom: evento de conversão customizado.
subscription_created, one_time_purchase, trial_converted, upgrade, custom "subscription_created"
Valor da conversão em centavos (inteiro). Ex.: 1990 = R$ 19,90.
0 <= x <= 90071992547409911990
Dados do cliente que originou a conversão.
Justificativa obrigatória do operador, registrada no evento conversion.created.
1 - 1000"Venda fechada por telefone, atribuída ao afiliado parceiro."
Moeda da conversão. Apenas BRL (Real brasileiro).
BRL Hash SHA-256 do e-mail do cliente.
^[a-f0-9]{64}$"a665a45920422f9d417e4867efdc4fb8a04a1f3fff1fa07e998e86f7f7a27ae3"
Identificador do evento de origem para deduplicação. Default: gerado automaticamente.
1 - 255"manual_order_2026-0001"
Data/hora em que a conversão ocorreu (ISO-8601). Default: agora.
"2026-06-13T12:00:00.000Z"
Identificador do produto vendido.
1 - 255"plan_pro_monthly"
Response
Default Response
Identificador único da conversão.
"conv_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Organização dona da conversão.
"org_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Programa ao qual a conversão pertence.
"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Afiliado a quem a conversão foi atribuída.
"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Clique vencedor da atribuição (null quando não atribuída por clique).
"clk_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Cupom usado na atribuição (null quando não houve cupom).
"coup_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Conversão original quando esta é uma recorrência derivada (null na conversão inicial).
"conv_01J9Z3K8N2QF4T7B9XP0WMD5RC"
Tipo da conversão. subscription_created: nova assinatura. one_time_purchase: compra avulsa. trial_converted: trial convertido em assinatura paga. upgrade: upgrade de plano. custom: evento de conversão customizado.
subscription_created, one_time_purchase, trial_converted, upgrade, custom "subscription_created"
Status da conversão. pending: aguardando revisão (ex.: travada por fraude). approved: aprovada e elegível a comissão. voided: anulada (manualmente ou por confirmação de fraude). refunded: estornada após reembolso do cliente.
pending, approved, voided, refunded "approved"
Valor da conversão em centavos. Ex.: 1990 = R$ 19,90.
-9007199254740991 <= x <= 90071992547409911990
Moeda da conversão.
"BRL"
Identificador do cliente na loja.
"cust_8842"
Hash SHA-256 do e-mail do cliente (null quando não informado).
Produto vendido (null quando não informado).
"plan_pro_monthly"
Identificador do evento de origem usado na deduplicação.
"order_2026-0001"
Origem do registro. api: enviada pela sua integração servidor-a-servidor. manual: criada por um operador. webhook: recebida do seu gateway de pagamento. script: disparada pelo tracker client-side no browser.
api, manual, webhook, script "api"
Método usado para atribuir a conversão a um afiliado. click_id: clique identificado. visitor_id: visitante rastreado. email_hash: hash de e-mail do cliente. fingerprint: impressão digital do dispositivo. coupon: cupom de afiliado. manual: atribuição manual por operador.
click_id, visitor_id, email_hash, fingerprint, coupon, manual "click_id"
Motivo de a comissão não ter sido gerada (null quando a comissão foi gerada normalmente).
program_paused, affiliate_paused, self_referral, product_not_applicable, pending_confirmation "affiliate_paused"
Decisão antifraude. approve: score abaixo do limite, aprovada automaticamente. monitor: aprovada, porém monitorada. review: travada para revisão manual. cleared: revisão manual concluiu falso positivo. confirmed: fraude confirmada (conversão anulada).
approve, monitor, review, cleared, confirmed "approve"
Motivo da anulação (null quando a conversão não foi anulada).
"Reembolso solicitado pelo cliente"
Snapshot da decisão de atribuição registrada na conversão.
Snapshot da regra de comissão aplicada (null quando nenhuma comissão foi gerada).
Snapshot da avaliação antifraude registrada na conversão.
Data/hora em que a conversão ocorreu (ISO-8601).
"2026-06-13T12:00:00.000Z"
Data/hora de criação do registro (ISO-8601).
"2026-06-13T12:00:05.000Z"
Data/hora da última atualização (ISO-8601).
"2026-06-13T12:00:05.000Z"