Confirma fraude (anula a conversão)

POST

fraud

checks

{conversionId}

confirm

Confirma fraude (anula a conversão)

curl --request POST \
  --url https://api.userepass.com/fraud/checks/{conversionId}/confirm \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.userepass.com/fraud/checks/{conversionId}/confirm"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.userepass.com/fraud/checks/{conversionId}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.userepass.com/fraud/checks/{conversionId}/confirm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.userepass.com/fraud/checks/{conversionId}/confirm"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.userepass.com/fraud/checks/{conversionId}/confirm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "conv_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "organizationId": "org_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "clickId": "clk_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "couponId": "coup_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "parentConversionId": "conv_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "type": "subscription_created",
  "status": "approved",
  "amountCents": 1990,
  "currency": "BRL",
  "customerId": "cust_8842",
  "customerEmailHash": "<string>",
  "productId": "plan_pro_monthly",
  "sourceEventId": "order_2026-0001",
  "source": "api",
  "matchMethod": "click_id",
  "commissionSkippedReason": "affiliate_paused",
  "fraudDecision": "approve",
  "voidReason": "Reembolso solicitado pelo cliente",
  "attributionSnapshot": {
    "model": "last_click",
    "windowDays": 30,
    "matchMethod": "click_id",
    "candidates": [
      {
        "clickId": "clk_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "occurredAt": "2026-06-10T09:30:00.000Z"
      }
    ],
    "winners": [
      {
        "clickId": "clk_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "weightBps": 10000
      }
    ],
    "gclid": "Cj0KCQiA_gclid_example",
    "couponPolicy": "click_wins"
  },
  "ruleSnapshot": {
    "precedence": "tier",
    "ruleId": "comm_01J9Z3K8N2QF4T7B9XP0WMD5RC",
    "version": 3,
    "type": "percentage",
    "percentageBps": 1500,
    "fixedAmountCents": 1990,
    "recurrence": {
      "kind": "one_time",
      "months": 12,
      "steps": [
        {
          "cycle": 1,
          "percentageBps": 1500
        }
      ]
    },
    "tiers": [
      {
        "minCount": 0,
        "percentageBps": 2000,
        "fixedAmountCents": 5000
      }
    ],
    "applicableProductIds": [
      "plan_pro_monthly",
      "plan_pro_yearly"
    ]
  },
  "fraudSnapshot": {
    "score": 0.12,
    "decision": "approve",
    "signals": [
      {
        "key": "ip_velocity",
        "weight": 0.3,
        "triggered": false,
        "detail": "3 conversões do mesmo IP em 1h"
      }
    ],
    "policy": {
      "approveBelow": 0.3,
      "reviewAbove": 0.7
    }
  },
  "occurredAt": "2026-06-13T12:00:00.000Z",
  "createdAt": "2026-06-13T12:00:05.000Z",
  "updatedAt": "2026-06-13T12:00:05.000Z"
}

Authorizations

Authorization

string

header

required

Chave de API (prefixo rstr_) enviada como Authorization: Bearer rstr_....

Path Parameters

conversionId

string

required

Pattern: ^conv_[0-9A-HJKMNP-TV-Z]{26}$

Response

200 - application/json

Default Response

string

required

Identificador único da conversão.

Example:

"conv_01J9Z3K8N2QF4T7B9XP0WMD5RC"

organizationId

string

required

Organização dona da conversão.

Example:

"org_01J9Z3K8N2QF4T7B9XP0WMD5RC"

programId

string

required

Programa ao qual a conversão pertence.

Example:

"prog_01J9Z3K8N2QF4T7B9XP0WMD5RC"

affiliateId

string

required

Afiliado a quem a conversão foi atribuída.

Example:

"aff_01J9Z3K8N2QF4T7B9XP0WMD5RC"

clickId

string | null

required

Clique vencedor da atribuição (null quando não atribuída por clique).

Example:

"clk_01J9Z3K8N2QF4T7B9XP0WMD5RC"

couponId

string | null

required

Cupom usado na atribuição (null quando não houve cupom).

Example:

"coup_01J9Z3K8N2QF4T7B9XP0WMD5RC"

parentConversionId

string | null

required

Conversão original quando esta é uma recorrência derivada (null na conversão inicial).

Example:

"conv_01J9Z3K8N2QF4T7B9XP0WMD5RC"

type

enum<string>

required

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.

Available options:

subscription_created,

one_time_purchase,

trial_converted,

upgrade,

custom

Example:

"subscription_created"

status

enum<string>

required

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.

Available options:

pending,

approved,

voided,

refunded

Example:

"approved"

amountCents

integer

required

Valor da conversão em centavos. Ex.: 1990 = R$ 19,90.

Required range: -9007199254740991 <= x <= 9007199254740991

Example:

1990

currency

string

required

Moeda da conversão.

Example:

"BRL"

customerId

string

required

Identificador do cliente na loja.

Example:

"cust_8842"

customerEmailHash

string | null

required

Hash SHA-256 do e-mail do cliente (null quando não informado).

productId

string | null

required

Produto vendido (null quando não informado).

Example:

"plan_pro_monthly"

sourceEventId

string

required

Identificador do evento de origem usado na deduplicação.

Example:

"order_2026-0001"

source

enum<string>

required

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.

Available options:

api,

manual,

webhook,

script

Example:

"api"

matchMethod

enum<string>

required

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.

Available options:

click_id,

visitor_id,

email_hash,

fingerprint,

coupon,

manual

Example:

"click_id"

commissionSkippedReason

enum<string> | null

required

Motivo de a comissão não ter sido gerada (null quando a comissão foi gerada normalmente).

Available options:

program_paused,

affiliate_paused,

self_referral,

product_not_applicable,

pending_confirmation

Example:

"affiliate_paused"

fraudDecision

enum<string>

required

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

Available options:

approve,

monitor,

review,

cleared,

confirmed

Example:

"approve"

voidReason

string | null

required

Motivo da anulação (null quando a conversão não foi anulada).

Example:

"Reembolso solicitado pelo cliente"

attributionSnapshot

object

required

Snapshot da decisão de atribuição registrada na conversão.

Show child attributes

ruleSnapshot

object | null

required

Snapshot da regra de comissão aplicada (null quando nenhuma comissão foi gerada).

Show child attributes

fraudSnapshot

object

required

Snapshot da avaliação antifraude registrada na conversão.

Show child attributes

occurredAt

string<date-time>

required

Data/hora em que a conversão ocorreu (ISO-8601).

Example:

"2026-06-13T12:00:00.000Z"

createdAt

string<date-time>

required

Data/hora de criação do registro (ISO-8601).

Example:

"2026-06-13T12:00:05.000Z"

updatedAt

string<date-time>

required

Data/hora da última atualização (ISO-8601).

Example:

"2026-06-13T12:00:05.000Z"

Confirma fraude (anula a conversão)

curl --request POST \
  --url https://api.userepass.com/fraud/checks/{conversionId}/confirm \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.userepass.com/fraud/checks/{conversionId}/confirm"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.userepass.com/fraud/checks/{conversionId}/confirm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.userepass.com/fraud/checks/{conversionId}/confirm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.userepass.com/fraud/checks/{conversionId}/confirm"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.userepass.com/fraud/checks/{conversionId}/confirm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "id": "conv_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "organizationId": "org_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "programId": "prog_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "clickId": "clk_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "couponId": "coup_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "parentConversionId": "conv_01J9Z3K8N2QF4T7B9XP0WMD5RC",
  "type": "subscription_created",
  "status": "approved",
  "amountCents": 1990,
  "currency": "BRL",
  "customerId": "cust_8842",
  "customerEmailHash": "<string>",
  "productId": "plan_pro_monthly",
  "sourceEventId": "order_2026-0001",
  "source": "api",
  "matchMethod": "click_id",
  "commissionSkippedReason": "affiliate_paused",
  "fraudDecision": "approve",
  "voidReason": "Reembolso solicitado pelo cliente",
  "attributionSnapshot": {
    "model": "last_click",
    "windowDays": 30,
    "matchMethod": "click_id",
    "candidates": [
      {
        "clickId": "clk_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "occurredAt": "2026-06-10T09:30:00.000Z"
      }
    ],
    "winners": [
      {
        "clickId": "clk_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "affiliateId": "aff_01J9Z3K8N2QF4T7B9XP0WMD5RC",
        "weightBps": 10000
      }
    ],
    "gclid": "Cj0KCQiA_gclid_example",
    "couponPolicy": "click_wins"
  },
  "ruleSnapshot": {
    "precedence": "tier",
    "ruleId": "comm_01J9Z3K8N2QF4T7B9XP0WMD5RC",
    "version": 3,
    "type": "percentage",
    "percentageBps": 1500,
    "fixedAmountCents": 1990,
    "recurrence": {
      "kind": "one_time",
      "months": 12,
      "steps": [
        {
          "cycle": 1,
          "percentageBps": 1500
        }
      ]
    },
    "tiers": [
      {
        "minCount": 0,
        "percentageBps": 2000,
        "fixedAmountCents": 5000
      }
    ],
    "applicableProductIds": [
      "plan_pro_monthly",
      "plan_pro_yearly"
    ]
  },
  "fraudSnapshot": {
    "score": 0.12,
    "decision": "approve",
    "signals": [
      {
        "key": "ip_velocity",
        "weight": 0.3,
        "triggered": false,
        "detail": "3 conversões do mesmo IP em 1h"
      }
    ],
    "policy": {
      "approveBelow": 0.3,
      "reviewAbove": 0.7
    }
  },
  "occurredAt": "2026-06-13T12:00:00.000Z",
  "createdAt": "2026-06-13T12:00:05.000Z",
  "updatedAt": "2026-06-13T12:00:05.000Z"
}