Revisa manualmente uma cobrança suspeita de fraude.

post https://app.vindi.com.br/api/v1/charges/{id}/fraud_review

Utilize este método para aprovar ou rejeitar uma cobrança suspeita de fraude (status=fraud_review).

O comportamento desta operação irá depender da configuração da integração antifraude:

Análise antes da autorização

Neste caso a análise ocorre antes da comunicação com a adquirente.

Aprovar (approve): A aprovação de uma suspeita de fraude irá disparar a tentativa de aprovação da transação junto à adquirente. Lembre-se que esta transação pode ser aprovada ou aprovada pela adquirente.
Rejeitar (reject): A rejeição atualizará o status da transação para rejeitado (rejected) com uma mensagem de erro genérica. Nenhuma tentativa é realizada na adquirente.

Análise depois da autorização

A análise ocorre após a autorização da adquirente.

Aprovar (approve): A plataforma Vindi executa a operação de captura na adquirente.
Rejeitar (reject): A rejeição dispara a operação de cancelamento da autorização na adquirente e gera uma transação de captura com o status rejected.

Responses

Response body

object

int32

required

ID da cobrança

amount

number

required

Valor da cobrança

status

string

required

Status da cobrança

pending paid canceled processing fraud_review

due_at

string

required

Data do vencimento da cobrança

paid_at

string

Data do pagamento da cobrança, apenas se a cobrança já foi paga

installments

int32

required

Número de parcelas da cobrança. Valores acima de 1 são usados apenas para parcelamento através da administradora do cartão de crédito

attempt_count

int32

Número de tentativas automáticas de cobrança já realizadas

next_attempt

int32

Data da próxima tentativa automática de cobrança

print_url

string

URL para impressão da cobrança. Usado apenas para boletos

created_at

string

required

Data e hora da geração da cobrança

updated_at

string

required

Data e hora da última atualização da cobrança

last_transaction

object

required

int32

required

ID da transação

transaction_type

string

required

Tipo da transação

charge refund authorization capture verify register void renew_payment_profile pre_authorization update

status

string

required

Status da transação

processing success rejected failure timeout waiting canceled fraud_review

amount

number

required

Valor da transação

installments

int32

required

Número de parcelas

gateway_message

string

required

Mensagem de resposta do gateway

gateway_response_code

string

required

Código de resposta do gateway

gateway_authorization

string

required

Código da autorização usado no estorno ou captura. Varia de acordo com o adquirente

gateway_transaction_id

string

required

Código externo de referência do gateway. Para boletos, representa o "nosso número"

gateway_response_fields

string

Atributos de resposta específicos do gateway

fraud_detector_score

number

Pontuação da análise antifraude entre 0.00 e 1.00. Quanto maior a pontuação, maior o risco de fraude

fraud_detector_status

string

Status da análise antifraude

automatic_success manual_success automatic_rejected manual_rejected review failure

fraud_detector_id

string

ID da análise antifraude

created_at

string

required

Data e hora da transação

gateway

object

required

payment_profile

object

required

payment_method

object

required

int32

required

ID do método de pagamento

public_name

string

required

Nome público do método de pagamento

name

string

required

Nome interno do método de pagamento

code

string

required

Código externo para referência via API

type

string

required

Tipo do método de pagamento

bill

object

required

int32

required

ID da fatura

code

string

Código externo para referência via API

customer

object

required

int32

required

ID do cliente

name

string

required

Nome do cliente

string

E-mail do cliente

code

string

Código opcional para referência via API

Language

Credentials

Basic

base64

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://app.vindi.com.br/api/v1/charges/id/fraud_review \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "fraud_review_action": "approve"
8
}
9
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Cobrança revisada com sucesso.

400Erro de sintaxe JSON no corpo do request.

404Recurso não encontrado: Cobrança

422Parâmetros inválidos. Verificar erro na resposta.