付款被拒

Xsolla Developers

或

付款被拒Webhook POST

当支付系统拒绝交易时，艾克索拉会将交易详情通过ps_declined类型的Webhook发送至您配置的Webhook URL。该Webhook在授权或支付处理阶段发送。此情况下，不会发送payment\ order_paid Webhook。

支付系统拒绝的常见原因：

卡片授权失败（例如，支付系统因技术错误或银行无响应而无法完成授权流程）或被拒（例如，银行已响应但因资金不足或卡片信息无效而拒绝交易）。
3-D Secure验证失败、未完成或用户确认超时。
处理方或收单银行暂时不可用，或因不可逆转的错误（如账户已关闭或卡号无效）而强制拒绝。在不解决根本问题的情况下重试将无法成功完成交易。

不应与以下情况混淆：

反欺诈拒绝，这类情况通过afs_reject Webhook报告。
成功支付后的退款和部分退款，这类情况通过refund和partial_refund webhook报告。

注意

如需接收ps_declined Webhook，请联系您的客户成功经理或发送邮件至csm@xsolla.com。

Request

Request Body schema: application/json

notification_type

required

string

通知类型。

required

object

交易ID。

dry_run	integer 测试交易。如为测试交易，该参数的值为1；如为真实交易，则不会发送该参数。
external_id	string 交易外部ID。
id	integer 交易ID。
payment_method	integer 付款方式ID。

object

退款详情（对象）。

author

string

退款发起人。根据下表传入字段值：

退款发起人	字段值
游戏（通过API）。	API
发布商帐户用户（自动退款）。	用户邮箱
发布商帐户用户（通过艾克索拉客户支持的帮助）。	support@xsolla.com
艾克索拉（通过艾克索拉客户支持的帮助）。	support@xsolla.com

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 用户名。

Responses

204

返回以指示处理成功。

400

提供的信息有错误（例如，缺少必需的参数、授权失败等）时返回。在这种情况下，用户的钱已扣，但是购买失败。要退款，请发送邮件至support@xsolla.com联系艾克索拉客户支持。

500

返回以指示您的服务器存在的暂时性错误。

Request samples

CURL
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 80543ba63e1e50cf05f15150fe75e7245da9a898' \
-d '{
  "notification_type": "ps_declined",
  "settings": {
    "project_id": "18404",
    "merchant_id": "2340"
  },
  "user": {
    "ip": "127.0.0.1",
    "email": "email@example.com",
    "id": "1234567",
    "country": "US"
  },
  "transaction": {
    "id": "1",
    "dry_run": "1",
    "payment_method": "1"
  },
  "refund_details": {
    "author": "support@xsolla.com",
    "code": "8",
    "reason": "Cancellation by the PS request",
    "reason_detail": "Insufficient funds"
  }
}'

Response samples

application/json

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