Транзакция отклонена при проверке системой Anti-fraud

Xsolla Developers

или

Транзакция отклонена при проверке системой Anti-fraudWebhook POST

Если транзакция была отклонена при проверке системой Anti-fraud, Xsolla присылает детали транзакции в вебхуке с типом afs_reject URL-адрес вебхука. Чтобы получать вебхук, обратитесь к персональному менеджеру проекта или напишите на csm@xsolla.com.

После сохранения URL-адреса вебхука в Личном кабинете вы можете настроить получение дополнительной информации в вебхуке. Для этого в разделе Настройки проекта > Вебхуки > Расширенные настройки установите следующий переключатель в активное положение.

Примечание

Если вы зарегистрировались в Личном кабинете до 22 января 2025 г. (включительно), переключатели располагаются в разделе Настройки проекта > Вебхуки > Тестирование > Payments > Расширенные настройки.

Переключатель Описание

Показывать информацию о транзакциях сохраненными способами оплаты

Переключатель	Описание
Показывать информацию о транзакциях сохраненными способами оплаты	В вебхуке будет передаваться информация в кастомных параметрах: `saved_payment_method`: `0` — сохраненный способ оплаты не используется; `1` — способ оплаты был сохранен при совершении текущей транзакции; `2` — используется ранее сохраненный способ оплаты. `payment_type`: `1` — единоразовый платеж; `2` — рекуррентный платеж.

В вебхуке будет передаваться информация в кастомных параметрах:

saved_payment_method:
- 0 — сохраненный способ оплаты не используется;
- 1 — способ оплаты был сохранен при совершении текущей транзакции;
- 2 — используется ранее сохраненный способ оплаты.
payment_type:
- 1 — единоразовый платеж;
- 2 — рекуррентный платеж.

Request

Request Body schema: application/json

notification_type

required

string

Тип оповещения.

required

object

Объект с информацией о транзакции, связанной с этой операцией.

agreement	integer ID соглашения.
dry_run	integer Признак тестовой транзакции. Значение параметра равно 1 для тестового платежа, для реального платежа параметр не передается.
external_id	string Внешний ID транзакции.
id	integer ID транзакции.

object

Объект с финансовыми данными рефанда.

author	string Автор рефанда.
code	integer ID кода.
reason	string Причина отмены.

object

Объект, содержащий настройки проекта.

merchant_id	integer ID продавца.
project_id	integer ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта.

object

Объект с информацией о пользователе.

id required	string ID пользователя.
country	string Страна пользователя. Используется двухбуквенное обозначение страны согласно стандарту ISO 3166-1 alpha-2.
email	string Email пользователя.
ip	string IP адрес пользователя.
name	string Имя пользователя.
phone	string Номер телефона пользователя (в международном формате).
zip	string Почтовый индекс.

Responses

204

Верните, чтобы сообщить об успешной обработке вехбука.

400

Верните в случае ошибки в предоставленной информации (например, обязательный параметр не передан, или авторизация не прошла).

500

Верните, чтобы сообщить о временных ошибках на ваших серверах.

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"
}
}