为付费优惠链步骤创建订单

管理
为 LLM 复制
将页面复制为 LLM 的 Markdown 格式
查看 Markdown
以 Markdown 格式打开此页面
在 ChatGPT 中打开
从 ChatGPT 获取见解
在 Claude 中打开
从 Claude 获取见解

操作

个性化目录
为 LLM 复制
将页面复制为 LLM 的 Markdown 格式
查看 Markdown
以 Markdown 格式打开此页面
在 ChatGPT 中打开
从 ChatGPT 获取见解
在 Claude 中打开
从 Claude 获取见解

此API可让您针对用户属性指定规则。如果用户满足具体规则的所有条件，则会显示个性化商品。

有关个性化促销活动的信息，请参阅促销活动部分。

要在购买前传递属性，您可以使用艾克索拉Login API或在使Pay Station API生成令牌时将它们传入user.attributes属性。

操作

管理
为 LLM 复制
将页面复制为 LLM 的 Markdown 格式
查看 Markdown
以 Markdown 格式打开此页面
在 ChatGPT 中打开
从 ChatGPT 获取见解
在 Claude 中打开
从 Claude 获取见解

操作

目录
为 LLM 复制
将页面复制为 LLM 的 Markdown 格式
查看 Markdown
以 Markdown 格式打开此页面
在 ChatGPT 中打开
从 ChatGPT 获取见解
在 Claude 中打开
从 Claude 获取见解

操作

购物车（客户端侧）
为 LLM 复制
将页面复制为 LLM 的 Markdown 格式
查看 Markdown
以 Markdown 格式打开此页面
在 ChatGPT 中打开
从 ChatGPT 获取见解
在 Claude 中打开
从 Claude 获取见解

操作

购物车（服务器侧）
为 LLM 复制
将页面复制为 LLM 的 Markdown 格式
查看 Markdown
以 Markdown 格式打开此页面
在 ChatGPT 中打开
从 ChatGPT 获取见解
在 Claude 中打开
从 Claude 获取见解

操作

支付（客户端）
为 LLM 复制
将页面复制为 LLM 的 Markdown 格式
查看 Markdown
以 Markdown 格式打开此页面
在 ChatGPT 中打开
从 ChatGPT 获取见解
在 Claude 中打开
从 Claude 获取见解

操作

使用指定商品创建订单Client-side

请求

用于客户端到服务器的集成。使用指定商品创建订单并为其生成支付令牌。创建的订单得到new订单状态。

客户端IP用于确定用户所在的国家/地区，然后用于为订单应用相应的货币和可用的支付方式。

要在新窗口中打开支付UI，请使用以下链接：https://secure.xsolla.com/paystation4/?token={token} ，其中{token}是收到的令牌。

如要进行测试，请使用以下URL：https://sandbox-secure.xsolla.com/paystation4/?token={token}。

注：

由于此方法使用IP来确定用户所在的国家/地区并为订单选择货币，因此必须从客户端而不是从服务器端使用此方法。从服务器端使用此方法可能会导致货币判断错误并影响支付中心中可用的支付方式。

安全

XsollaLoginUserJWT

路径

project_idinteger必需

项目ID。您可以在您的发布商帐户项目名称旁边找到。

示例: 44056

item_skustring必需

商品SKU。

示例: booster_mega_1

正文application/json

currencystring

订单价格货币。每笔订单的三个字母的货币代码ISO 4217。请查看文档以获取有关Xsolla 支持的货币。

custom_parametersobject[ 1 .. 200 ] properties

项目特定参数。

localestring

响应语言。

promo_codestring

随支付兑换促销码活动代码。

quantityinteger>= 1

商品数量。

默认值 1

sandboxboolean

在沙盒模式下创建订单。该选项适用于公司用户列表中指定的那些用户。

默认值 false

settingsobject

为用户配置支付流程和支付UI的设置。

curl -i -X POST \
  https://xsolla.redocly.app/_mock/zh/api/shop-builder/v2/project/44056/payment/item/booster_mega_1 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "custom_parameters": {
      "character_id": "ingameUsername"
    },
    "promo_code": "discount_code",
    "quantity": 5,
    "sandbox": true,
    "settings": {
      "ui": {
        "desktop": {
          "header": {
            "close_button": false,
            "is_visible": true,
            "type": "normal",
            "visible_logo": true,
            "visible_name": true,
            "visible_purchase": true
          }
        },
        "theme": "63295a9a2e47fab76f7708e1"
      }
    }
  }'

响应

订单已成功创建。

正文application/json

order_idinteger

订单ID。

tokenstring

支付令牌。

响应

application/json

{
  "order_id": 641,
  "token": "f4puMEFFDZcx9nv5HoNHIkPe9qghvBQo"
}