进行部分退款后,艾克索拉向Webhook
URL发送一个partial_refund
类型的Webhook并在其中包含已取消交易的详细信息。有关部分退款流程的详细信息请参阅这些说明。
您可以授予在Webhook中接收详细信息的权限。为此,您可以在发布商帐户的项目设置 > Webhooks > 高级设置 部分将以下开关切换为开:
开关 | 描述 |
---|---|
显示通过保存的支付方式进行的交易的信息 | 信息在Webhook的以下自定义参数中传递:
|
退款代码:
代码 | 退款理由 | 描述 |
---|---|---|
1 | Cancellation by the user request / the game request | 用于在发布商帐户中发起取消的情况。 |
3 | Integration error | 用于艾克索拉与游戏之间存在集成问题的情况。 这种情况下,我们不建议将用户列入黑名单。 |
5 | Test payment | 用于测试交易然后取消的情况。 这种情况下,我们不建议将用户列入黑名单。 |
7 | Fraud notification from PS | 支付被支付系统拒绝。 支付系统检测到潜在欺诈行为。 建议:将该用户添加到黑名单。 |
9 | Cancellation by the user request | 用于用户请求取消的情况。可能出于某些原因导致用户对游戏或购买产生不满的情况下发生。 这种情况下,我们不建议将用户列入黑名单。 |
10 | Cancellation by the game request | 用于游戏请求取消的情况。 这种情况下,我们不建议将用户列入黑名单。 |
notification_type required | string 通知类型。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object 交易ID。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
required | object 带有支付详细信息的对象。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
custom_parameters | object 您的自定义参数。 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 带有购买相关数据的对象。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 退款详情(对象)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 带有自定义项目设置的对象。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
object 用户详情(对象)。 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
返回以指示处理成功。
提供的信息出错时返回(例如,缺少必需的参数、授权失败等)。
返回以指示您的服务器存在的暂时性错误。
curl -v 'https://your.hostname/your/uri' \ -X POST \ -d '{ "notification_type": "partial_refund", "settings": { "project_id": 18404, "merchant_id": 2340 }, "purchase": { "checkout": { "currency": "USD", "amount": 50 }, "total":{ "currency": "USD", "amount": 200 } }, "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, "date": "2022-03-01 10:53:15" }, "refund_details": { "author": "email@example.com", "date": "2022-03-01 10:56:48" }, "payment_details": { "sales_tax": { "currency": "USD", "amount": 0 }, "direct_wht": { "currency": "USD", "amount": 0.70 }, "xsolla_fee": { "currency": "USD", "amount": "10" }, "payout": { "currency": "USD", "amount": "200" }, "payment_method_fee": { "currency": "USD", "amount": "20" }, "payment": { "currency": "USD", "amount": "230" }, "repatriation_commission": { "currency": "USD", "amount": 10 } } } }'
{- "error": {
- "code": "INCORRECT_AMOUNT",
- "message": "Incorrect amount"
}
}