反欺诈系统拒绝了交易

反欺诈系统拒绝了交易Webhook POST

当交易在反欺诈系统检查期间被拒绝时，艾克索拉会向Webhook URL发送一个包含交易详情的afs_reject类型的Webhook。要接收该Webhook，请联系您的客户成功经理或发送电子邮件至csm@xsolla.com。

You can give permissions to receive detailed information in webhooks. To do that, you can set the following toggle to On in Publisher Account in the Project settings > Webhooks > Advanced settings section:

开关描述

显示通过保存的支付方式进行的交易的信息

开关	描述
显示通过保存的支付方式进行的交易的信息	信息在Webhook的以下自定义参数中传递： `saved_payment_method`: `0` — 未使用保存的支付方式 `1` — 进行当前付款时保存了支付方式 `2` — 使用了之前保存的支付方式 `payment_type`: `1` — 一次性支付 `2` — 定期支付

信息在Webhook的以下自定义参数中传递：

saved_payment_method:
- 0 — 未使用保存的支付方式
- 1 — 进行当前付款时保存了支付方式
- 2 — 使用了之前保存的支付方式
payment_type:
- 1 — 一次性支付
- 2 — 定期支付

Request

Request Body schema: application/json

notification_type

required

string

通知类型。

required

object

交易ID。

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 项目编号。您可以在您的发布商帐户项目名称旁边。

object

用户详情（对象）。

id required	string 用户ID。
country	string 用户所在国家/地区。使用ISO 3166-1 alpha-2 标准规定的2字母组合表示国家/地区。
email	string 用户电子邮件。
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"
}
}