Analyzing a transaction at Cybersource

Analyzes fraud risk and recommends whether to accept, review, or reject the transaction, before or after authorization.

EnvironmentMethodEndpoint
Sandboxhttps://risksandbox.braspag.com.br/analysis/v2/
Productionhttps://risk.braspag.com.br/analysis/v2/
ℹ️

Alphanumeric CNPJs will be implemented by the Brazilian Federal Revenue Service in July 2026

This change applies only to new registrations. There will be no changes to existing CNPJs.

The alphanumeric CNPJ is already supported by Cielo, with no changes required to your integration.

We recommend checking whether adjustments are needed in your merchant’s own checkout systems.


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

⚠️

Warning


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

  • The BraspagTransactionId field is required.
  • In the BraspagTransactionId field, send the value received during authorization in the Payment.PaymentId parameter.
  • The Tid, Nsu, AuthorizationCode, and SaleDate fields do not need to be sent.
  • If the merchant operates with Antifraude before authorization, the authorization association must be implemented

Warning:
The absence of the BraspagTransactionId parameter or the association between analysis and authorization will prevent automatic chargeback feedback to the Antifraude provider.


If there is no integration with the Cielo Payment Gateway API or the Cielo E-commerce API:

  • The Tid, Nsu, AuthorizationCode, and SaleDate fields become required.
  • The BraspagTransactionId field does not need to be sent.
Body Params
string
required

Order number.

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

Antifraud provider.
Table 1 - Provider

Allowed:
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
CartItem
object
Bank
object
FundTransfer
object
Invoice
object
Airline
object
CustomConfiguration
object
MerchantDefinedData
object
required
Headers
string
required

Bearer {access_token}

string
required

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

string
required

nnnnnnnn-nnnn-nnnn-nnnn-nnnnnnnnnnnn

Response

Language
LoadingLoading…
Response
Choose an example:
application/json