O sistema antifraude rejeitou a transação

Xsolla Developers

O sistema antifraude rejeitou a transaçãoWebhook POST

Quando uma transação é recusada durante uma verificação do sistema antifraude, a Xsolla envia detalhes da transação no webhook com o tipo afs_reject para o URL do webhook. Para receber este webhook, entre em contato com seu Gerente de Sucesso do Cliente ou envie um e-mail para csm@xsolla.com.

Ao salvar o URL do webhook na Conta de Distribuidor, você pode conceder permissões para receber informações detalhadas nos webhooks. Para fazer isso, defina a seguinte opção como ativa na Conta de Distribuidor na seção Project settings > Webhooks > Advanced settings.

Observação

Se você se registrou na Conta de Distribuidor no dia 22 de janeiro de 2025 ou antes, você encontrará as opções na seção Project settings > Webhooks > Testing > Payments > Advanced settings.

Opção Descrição

Exibir informações sobre transações pelos métodos de pagamento salvos

Opção	Descrição
Exibir informações sobre transações pelos métodos de pagamento salvos	As informações são passadas nos seguintes parâmetros personalizados do webhook: `saved_payment_method`: `0` — o método de pagamento guardado não foi utilizado `1` — o método de pagamento foi salvo ao efetuar o pagamento atual `2` — o método de pagamento previamente guardado é utilizado `payment_type`: `1` — pagamento único `2` — pagamento recorrente

As informações são passadas nos seguintes parâmetros personalizados do webhook:

saved_payment_method:
- 0 — o método de pagamento guardado não foi utilizado
- 1 — o método de pagamento foi salvo ao efetuar o pagamento atual
- 2 — o método de pagamento previamente guardado é utilizado
payment_type:
- 1 — pagamento único
- 2 — pagamento recorrente

Request

Request Body schema: application/json

notification_type

required

string

Tipo de notificação.

required

object

Detalhes da transação (objeto).

agreement	integer ID do contrato.
dry_run	integer Transação de teste. O parâmetro tem valor 1 se for uma transação de teste ou não for enviado se a transação for real.
external_id	string ID externo de transação.
id	integer ID de transação.

object

Detalhes do reembolso (objeto).

author	string Iniciador de reembolso.
code	integer ID do código.
reason	string Motivo do reembolso.

object

Configurações personalizadas do projeto (objeto).

merchant_id	integer ID de comerciante.
project_id	integer ID do projeto. Você pode encontrar esse parâmetro em sua Conta de Distribuidor ao lado do nome do projeto.

object

Dados do usuário (objeto).

id required	string ID de usuário.
country	string País do usuário. Código de país de duas letras maiúsculas, de acordo com o ISO 3166-1 alpha-2.
email	string E-mail do usuário.
ip	string IP do usuário.
name	string Nome de usuário.
phone	string Telefone do usuário.
zip	string CEP ou código postal do usuário.

Responses

204

Retorne para indicar o processamento bem-sucedido.

400

Retorne em caso de erro nas informações fornecidas (por exemplo, um parâmetro obrigatório ausente, falha na autorização, etc.).

500

Retorne para indicar erros temporários com seus servidores.

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-d '{
  "notification_type": "afs_reject",
  "settings": {
    "project_id": 18404,
    "merchant_id": 2340
  },
  "user": {
    "ip": "127.0.0.1",
    "phone": "18777976552",
    "email": "email@example.com",
    "id": "1234567",
    "name": "John Smith",
    "country": "US"
  },
  "transaction": {
    "id": 1,
    "external_id": 1,
    "dry_run": 1,
    "agreement": 1
  },
  "refund_details": {
    "code": 4,
    "reason": "Potential fraud"
  }
}'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}