Realizar análise de fraude na ACI Worldwide

post

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

Analisa o risco de fraude de uma transação com o provider ACI Worldwide.

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

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

ℹ️
Importante
Quando o seu provedor de antifraude é a ACI Worldwide, envie o valor "RedShield" no campo Provider.

ℹ️
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

enum

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

Allowed:

Provider

string

enum

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

Allowed:

OrderDate

date

Data do pedido
Ex.: 2016-12-09 19:16:38.155
Obs.: Caso não seja informada, uma data será gerada pela Braspag

BraspagTransactionId

string

Id da transação no Gateway de Pagamento

Tid

string

Id da transação na adquirente
Obs.: Caso você não possua integração com o Gateway de Pagamento, não terá como enviar o campo BraspagTransactionId, com isso é necessário o envio dos campos Nsu, AuthorizationCode e SaleDate, além deste em questão. Tamanho: 20.

Nsu

string

Número sequencial único da transação na adquirente
Obs.: Caso você não possua integração com o Gateway de Pagamento, não terá como enviar o campo BraspagTransactionId, com isso é necessário o envio dos campos Tid, AuthorizationCode e SaleDate, além deste em questão. Tamanho: 10.

AuthorizationCode

string

Código de autorização da transação na adquirente
Obs.: Caso você não possua integração com o Gateway de Pagamento, não terá como enviar o campo BraspagTransactionId, com isso é necessário o envio dos campos Tid, Nsu e SaleDate, além deste em questão. Tamanho: 10.

SaleDate

date

Data da autorização da transação da transação na adquirente
Obs.: Caso você não possua integração com o Gateway de Pagamento, não terá como enviar o campo BraspagTransactionId, com isso é necessário o envio dos campos Tid, Nsu e AuthorizationCode, além deste em questão

SplitingPaymentMethod

string

enum

Identifica se a autorização da transação é com um ou mais cartões ou com mais de um meio de pagamento
Tabela 2 - SplitingPaymentMethod

Allowed:

IsRetryTransaction

boolean

Retentativa de uma análise, e deverá ser enviado com valor igual a TRUE quando o código de retorno na primeira tentativa for igual a BP900

Card

object

Billing

object

Shipping

object

Customer

object

CartItems

object

Airline

object

CustomConfiguration

object

MerchantDefinedData

object

Headers

Authorization

string

required

Bearer {access_token}

MerchantId

string

required

xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Response

Importante

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

200200