Analyzing a transaction at Cybersource

Analyzes fraud risk of a transaction.

Environment Method Endpoint
Sandbox d> `https://risksandbox.braspag.com.br/analysis/v2/`
Production ion td> d> `https://risk.braspag.com.br/analysis/v2/`

The analysis can be performed before or after authorization, and the response returns the recommendation to accept, review, or reject the transaction.

ℹ️

Learn more about this feature in the documentation.

⚠️

Warning


If there is integration with the Cielo Gateway de Pagamento API or the API E-commerce Cielo:

  • The BraspagTransactionId field is required;

  • The BraspagTransactionId field corresponds to the PaymentId returned by the Gateway de Pagamento or API E-commerce Cielo;

  • The Tid, Nsu, AuthorizationCode, and SaleDate fields do not need to be sent;

  • If the e-commerce operates with antifraud before authorization, the authorization association must be implemented.

    Important: The absence of the BraspagTransactionId parameter or of the analysis-authorization association will prevent automatic chargeback feedback to the antifraud provider.


If there is no integration with the Cielo Gateway de Pagamento API and API E-commerce Cielo:

  • The Tid, Nsu, AuthorizationCode, and SaleDate fields become required;
  • The BraspagTransactionId field does not need to be sent.
ℹ️

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.

⚠️

Warning

This call is used only for integrations that consume fraud analysis in a standalone manner.

If you use Antifraude integrated with the Gateway de Pagamento or the API E-commerce Cielo, this reference does not apply. See the specific documentation for the product used:

Body Params
string
required

Order number. Size: 100.

int64
required

Total order amount in cents.
Example: 123456 = R$ 1,234.56.

int64
required

Financial transaction amount in cents.
Example: 150000 = R$ 1.500,00

string
required

Currency code. More information in ISO 4217 Currency Codes

string
enum

Fraud analysis solution provider.
Table 1 - Provider

Allowed:
date

Order date and time.

string

Transaction identifier returned by the API Gateway de Pagamento Cielo or the API E-commerce Cielo. Mandatory when there is integration with any of these APIs.

string

Transaction identifier at the acquirer. Mandatory when there is no integration with the API Gateway de Pagamento or the Cielo E-commerce API.

string

Unique sequential number of the transaction at the acquirer. Mandatory when there is no integration with the API Gateway de Pagamento or the Cielo E-commerce API.

string

Authorization code of the transaction at the acquirer. Mandatory when there is no integration with the API Gateway de Pagamento or the Cielo E-commerce API.

date

Authorization date of the transaction at the acquirer. Mandatory when there is no integration with the API Gateway de Pagamento or the Cielo E-commerce API.

Card
object
Billing
object
Shipping
object
Customer
object
CartItems
object
CustomConfiguration
object
Airline
object
BankData
object
FundTransfer
object
Invoice
object
MerchantDefinedData
object
required
Headers
string
required

Bearer {access_token}

string
required

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

string
required

nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn

Responses

Language
LoadingLoading…
Response
Choose an example:
application/json