通过直接链接销售

注:

配置直接链接销售前,请先在帐户中创建游戏 Key 套餐。

此外,您可以在项目中设置以下内容:

借助直接链接,您可以在任何支持打开网页或应用内浏览器的渠道销售游戏 Key,例如游戏官网、社交媒体、启动器、邮件通讯或博主帖子中。

该链接会打开艾克索拉的订单页面。用户在此页面完成整个购买流程:下单并支付。您无需自行开发用户界面。

该方式适用于以下场景:

  • 需要在不同渠道快速上线游戏销售或预售。只需将链接投放到网站、社交媒体或邮件通讯中。
  • 需要减少因邮件地址填写错误或平台不兼容引发的客服请求。用户会在订单页面补全缺失信息;若销售多平台 Key,还可在 SKU 中预设平台(参见链接格式与参数)。

用户流程

  1. 用户打开链接。
  2. 艾克索拉显示订单页面。
  3. 用户填写链接中未传递的数据:
    1. 选择有可用 Key 的平台。
    2. 输入兑换码(可选)。
    3. 输入用于接收收据、游戏 Key 和激活说明的邮件地址,并点击 Continue。
  1. 页面再次显示所填邮件地址。用户确认无误,或点击 Change 进行修改。
注:

下单步骤可能会有所不同:

  • 如果传入的游戏 Key 套餐 SKU 未指定平台,则可选择平台。
  • 仅当该游戏 Key 套餐或捆绑包有生效中的兑换码时,才可输入兑换码。
  • 对于已认证用户,订单表单会从用户数据中自动填入邮件地址。
  1. 艾克索拉为所选平台预留游戏 Key 并打开支付 UI。
  2. 用户完成支付。
  3. 支付成功后,艾克索拉会向已确认的邮件地址发送包含收据、游戏 Key 和激活说明的邮件。

用于销售游戏 Key 的链接格式如下:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}

查询参数列表:

参数描述
type

商品类型。必填。

可选值:

project_id

项目 ID,可通过以下位置查看:

  • 在发布商帐户顶部栏中点击项目名称,显示于项目名称旁。
  • 任意发布商帐户页面的 URL 中。URL 格式如下:https://publisher.xsolla.com/<merchant_id>/projects/<project_id>/。

必填。

sku

游戏 Key 套餐的 SKU。必填。

示例:

  • game456 — 未指定平台的 SKU。
  • game456_steam — 指定平台的 SKU。艾克索拉支持的平台列表及后缀示例见下表。

为确保链接正常运行,可通过获取游戏列表 API 调用核对 SKU 值。商品 SKU 会在 items.unit_items.sku 参数中返回(通常格式为 game_key_sku_drm_sku)。

xsolla_login_token通过艾克索拉登录管理器获取的用户身份认证令牌 (JWT)。详情参见向已认证用户销售。
access_data以 Base64 编码的 JSON 对象,包含用户数据和支付设置。详情参见向已认证用户销售。
auth通过支付收银台获取的用户身份认证令牌。详情参见向已认证用户销售。
ui_settings以 Base64 编码的 JSON 对象,包含用户界面主题设置。详情参见自定义用户界面。
mode传入 sandbox 值以进行测试支付。详情参见支付测试。
参数描述
type

商品类型。必填。

可选值:

project_id

项目 ID,可通过以下位置查看:

  • 在帐户顶部栏中点击项目名称,显示于项目名称旁。
  • 任意帐户页面的 URL 中。URL 格式如下:https://xsolla.com/for/<business-account-type>/account/<merchant_id>/projects/<project_id>/。

必填。

sku

游戏 Key 套餐的 SKU。必填。

示例:

  • game456 — 未指定平台的 SKU。
  • game456_steam — 指定平台的 SKU。艾克索拉支持的平台列表及后缀示例见下表。

为确保链接正常运行,可通过获取游戏列表 API 调用核对 SKU 值。商品 SKU 会在 items.unit_items.sku 参数中返回(通常格式为 game_key_sku_drm_sku)。

xsolla_login_token通过艾克索拉登录管理器获取的用户身份认证令牌 (JWT)。详情参见向已认证用户销售。
access_data以 Base64 编码的 JSON 对象,包含用户数据和支付设置。详情参见向已认证用户销售。
auth通过支付收银台获取的用户身份认证令牌。详情参见向已认证用户销售。
ui_settings以 Base64 编码的 JSON 对象,包含用户界面主题设置。详情参见自定义用户界面。
mode传入 sandbox 值以进行测试支付。详情参见支付测试。

若要销售面向特定平台的游戏 Key 套餐,请在 sku 查询参数中传入带平台后缀的游戏 Key 套餐 SKU。后缀会自动添加或需手动指定,具体取决于套餐的创建方式:

  • 如果在帐户中创建游戏 Key 套餐,系统会在手动输入的 SKU 后自动添加特定平台的后缀(例如 _steam 或 _playstation),并以下划线分隔。
  • 如果通过 API 调用创建面向特定平台的游戏 Key 套餐,可自定义平台后缀格式,但只能使用英文大小写字母、数字、点、短横线和下划线。

艾克索拉支持的平台及后缀示例:

名称SKU 后缀示例
Steam_steam
PlayStation_playstation
Xbox_xbox
Uplay_uplay
Origin_origin
DRM Free_drmfree
GOG_gog
Epic Games_epicgames
Nintendo Switch eShop_nintendo_eshop
Discord Game Store_discord_game_store
Oculus_oculus
Viveport_viveport
Google Stadia_stadia
MY.GAMES Store_my_game

注:
如果在链接中传入了带特定平台的游戏 Key 套餐 SKU,用户无法在订单页面更改平台。

Steam 游戏销售 URL 示例:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam

自定义用户界面

为使订单页面与游戏风格保持一致,请参照自定义说明配置主题、尺寸等参数。在链接中添加 ui_settings 参数,并将 settings.ui JSON 对象经 Base64 编码后传入其中。

使用自定义主题打开订单页面的 URL 示例:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&ui_settings=ewoJCQkic2l6ZSI6ICJzbWFsbCIsCgkJCSJ0aGVtZSI6ICJkYXJrIgoJCX0=

向已认证用户销售

注:

通过直接链接销售游戏 Key 无需进行身份认证。Key 会发送到用户在购买时填写的邮件地址。若需限制每位用户的 Key 数量、使用权益系统或在艾克索拉支付 UI 中保存用户数据,则需进行用户身份认证。

增加一步身份认证可能会降低购买转化率。

要向已认证用户销售游戏 Key,请在链接中添加以下任一参数:

  • xsolla_login_token — 通过艾克索拉登录管理器获取的 JWT。若您使用艾克索拉登录管理器进行用户身份认证,请使用该参数。要获取令牌,请通过登录管理器 API 完成用户身份认证,例如使用通过用户名和密码进行身份认证调用。
  • auth — 通过支付收银台获取的令牌。若您有自有身份认证系统,请使用该参数。要获取令牌,请从服务端发送创建令牌请求。详情参见获取用于打开支付 UI 的令牌。
  • access_data — 以 Base64 编码的 JSON 对象,包含用户数据和支付设置。若您有自有身份认证系统,或需要传递邮件地址与国家/地区,请使用该参数。该对象的结构与创建令牌调用的请求正文(user 与 settings 对象)一致。

编码前的 access_data JSON 示例:

Copy
Full screen
Small screen
 1{
 2  "user": {
 3    "id": {
 4      "value": "USER_ID"
 5    },
 6    "email": {
 7      "value": "[email protected]"
 8    },
 9    "country": {
10      "value": "US"
11    }
12  },
13  "settings": {
14    "language": "en",
15    "currency": "USD"
16  }
17}

对该 JSON 对象进行 Base64 编码,并将结果传入链接的 access_data 参数。

关于身份认证方式及生成身份认证令牌的详细信息,请参见如何为销售游戏 Key 设置身份认证。

使用身份认证令牌打开订单页面的 URL 示例:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&xsolla_login_token={ACCESS_TOKEN}

支付测试

要在沙盒模式下测试支付,请在链接中添加 mode=sandbox 参数。您可以使用测试银行卡完成交易。

沙盒模式下打开订单页面的 URL 示例:

Copy
Full screen
Small screen
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
注意
在沙盒模式下购买不会消耗已上传的游戏 Key。系统仅模拟成功购买,不会发放实际游戏 Key。
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2026年11月19日

发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈!
无法发送您的反馈
请稍后重试或发送邮件至[email protected]与我们联系。