Xsolla-logo

订单取消Webhook POST

当满足以下条件时,艾克索拉将order_canceled webhook发送到指定的 URL:

  1. 付款被用户、合作伙伴取消或自动取消。
  2. 艾克索拉收到成功处理refund webhook的响应。

order_canceled webhook包含退货商品的信息和取消的交易的详细信息。

如果出现以下情况,将不会发送order_canceled webhook:

  • 支付不成功,例如:
    • 打开了支付表单,但用户没有为订单付款
    • 打开了支付表单,但付款过程中出现错误
  • 尚未收到成功处理refund webhook的响应。

建议order_canceled webhook的处理速度小于3秒。

Request
Request Body schema: application/json
notification_type
required
string

通知类型。

required
Array of objects

用户所购商品的列表。

Array
sku
required
string

项目的唯一ID。对于game_key类型的商品,使用sku_drm格式的值。

type
required
string

商品类型。它可以具有以下值:virtual_goodvirtual_currencygame_keybundle。对于bundle类型的商品(包括虚拟货币套餐),商品数组将显示:

  • 捆绑包或虚拟货币套餐的参数
  • 捆绑包中包含的商品或套餐中包含的货币
Enum: "virtual_good" "virtual_currency" "game_key" "bundle"
quantity
required
integer

商品数量。

amount
required
string

基于数量的商品总价。如果汇率和佣金有变,则可能与商品价格不一致。

required
Array of objects

应用促销。如果未应用促销,则会在参数中传递一个空数组。

Array
amount_with_discount
string

应用折扣后商品总价。

amount_without_discount
string

不应用折扣的商品总价。

sequence
integer

所应用促销的ID。

is_pre_order
required
boolean

如果为true,则商品为预售。

required
object

订单信息。

id
required
integer

艾克索拉侧用户订单的唯一标识符。

mode
required
string

付款模式。对于真实支付,使用default;对于测试性支付,使用sandbox

Enum: "default" "sandbox"
currency_type
required
string

支付货币类型。对于免费订单,则值指定为unknown

Enum: Description
real

对于真实货币

unknown

对于免费订单

virtual

对于虚拟货币

currency
required
string

订单货币。虚拟货币使用SKU,真实货币使用三个字母的ISO 4217代码。

amount
required
string

基于所选货币的购物车总价。

status
required
string

订单状态

platform
required
string or null

支付平台。 xsolla值用于通过艾克索拉进行的支付。其他支付使用游戏发布平台名称对应的值:playstation_networkxbox_livepc_standalonenintendo_shopgoogle_playapp_store_iosandroid_standaloneios_standaloneandroid_otherios_otherpc_other

Enum: "xsolla" "playstation_network" "xbox_live" "pc_standalone" "nintendo_shop" "google_play" "app_store_ios" "android_standalone" "ios_standalone" "android_other" "ios_other" "pc_other"
comment
required
string or null

用户对订单的备注。

invoice_id
required
string or null

实际货币付款发票ID。虚拟货币付款或免费商品的值为null

required
Array of objects

应用促销。如果未应用促销,则会在参数中传递一个空数组。

Array
amount_with_discount
string

应用折扣后商品总价。

amount_without_discount
string

不应用折扣的商品总价。

sequence
integer

所应用促销的ID。

Array of objects

应用的优惠券。如未应用优惠券,则不会返回该数组。

Array
code
string

应用的优惠券的券码。

external_id
string

外部ID。

Array of objects

应用的促销码。如未应用促销码,则不会返回该数组。

Array
code
string

应用的促销码的代码。

external_id
string

外部ID。

required
object

用户信息。

external_id
required
string

用户ID。

email
required
string

用户邮箱地址。

custom_parameters
object

附加信息。

Responses
200

返回以指示处理成功。

400

提供的信息出错时返回(例如,缺少必需的参数、授权失败等)。

Request samples
application/json
{
  • "custom_parameters": { },
  • "items": [ ],
  • "notification_type": "string",
  • "order": {
    },
  • "user": {
    }
}