Realizar análise de fraude com Cybersource

post

https://risksandbox.braspag.com.br/analysis/v2/

Analisa o risco de fraude em uma transação.

Ambiente	Método	Endpoint
Sandbox	post	`https://risksandbox.braspag.com.br/analysis/v2/`
Produção	post	`https://risk.braspag.com.br/analysis/v2/`

A análise pode ser feita antes ou depois da autorização e a resposta retorna a recomendação de aceitar, revisar ou rejeitar a transação.

ℹ️
Saiba mais sobre essa funcionalidade na documentação.

⚠️
Atenção
Se houver integração com a API do Gateway de Pagamento Cielo ou com a API E-commerce Cielo:

O campo BraspagTransactionId é obrigatório;

O campo BraspagTransactionId corresponde ao PaymentId retornado pelo Gateway de Pagamento ou API E-commerce Cielo;

Os campos Tid, Nsu, AuthorizationCode e SaleDate não precisam ser enviados;

Caso o e-commerce opere com antifraude antes da autorização, a associação de autorização deve ser implementada.

Importante: A ausência do parâmetro BraspagTransactionId ou associação da análise com autorização impedirá a retroalimentação automática de chargeback no provedor de antifraude.

Se não houver integração com a API Gateway de Pagamento Cielo e API E-commerce Cielo:

Os campos Tid, Nsu, AuthorizationCode e SaleDate tornam-se obrigatórios;

O campo BraspagTransactionId não precisa ser enviado.

ℹ️
CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026
Essa mudança afeta apenas novas inscrições, não havendo mudanças em CNPJs existentes.
O CNPJ alfanumérico já está sendo suportado pela Cielo, sem mudanças na sua integração.
Recomendamos verificar a necessidade de possíveis ajustes nos sistemas próprios de checkout de sua loja.

Body Params

MerchantOrderId

string

required

Número do pedido da loja. Tamanho: 100.

TotalOrderAmount

int64

required

Valor total do pedido em centavos
Ex: 123456 = R$ 1.234,56.

TransactionAmount

int64

required

Valor da transação financeira em centavos
Ex: 150000 = R$ 1.500,00.

Currency

string

required

Moeda. Maiores informações em ISO 4217 Currency Codes. Tamanho: 3.

Provider

string

enum

required

Provedor da solução de análise de fraude.
Tabela 1 - Provider

Allowed:

OrderDate

date

Data e horário do pedido.

BraspagTransactionId

string

Identificador da transação. Corresponde ao PaymentId retornado pelo Gateway de Pagamento ou API E-commerce Cielo. Obrigatório quando houver integração com qualquer uma dessas APIs.

Tid

string

Identificador da transação na adquirente. Obrigatório quando não houver integração com a API do Gateway de Pagamento Cielo ou com a API E-commerce Cielo.

Nsu

string

Número sequencial único da transação na adquirente. Obrigatório quando não houver integração com a API do Gateway de Pagamento Cielo ou com a API E-commerce Cielo.

AuthorizationCode

string

Código de autorização da transação na adquirente. Obrigatório quando não houver integração com a API do Gateway de Pagamento Cielo ou com a API E-commerce Cielo.

SaleDate

date

Data da autorização da transação na adquirente. Obrigatório quando não houver integração com a API do Gateway de Pagamento Cielo ou com a API E-commerce Cielo.

Card

object

Billing

object

Shipping

object

Customer

object

CartItems

object

CustomConfiguration

object

Airline

object

BankData

object

FundTransfer

object

Invoice

object

MerchantDefinedData

object

required

Headers

Authorization

string

required

Bearer {access_token}

MerchantId

string

required

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Responses

CNPJs alfanuméricos serão implementados pela Receita Federal em julho de 2026

200200

400400