通过直接链接销售
借助直接链接,您可以在任何支持打开网页或应用内浏览器的渠道销售游戏 Key,例如游戏官网、社交媒体、启动器、邮件通讯或博主帖子中。
该链接会打开艾克索拉的订单页面。用户在此页面完成整个购买流程:下单并支付。您无需自行开发用户界面。
该方式适用于以下场景:
- 需要在不同渠道快速上线游戏销售或预售。只需将链接投放到网站、社交媒体或邮件通讯中。
- 需要减少因邮件地址填写错误或平台不兼容引发的客服请求。用户会在订单页面补全缺失信息;若销售多平台 Key,还可在 SKU 中预设平台(参见链接格式与参数)。
用户流程
- 用户打开链接。
- 艾克索拉显示订单页面。
- 用户填写链接中未传递的数据:
- 选择有可用 Key 的平台。
- 输入兑换码(可选)。
- 输入用于接收收据、游戏 Key 和激活说明的邮件地址,并点击 Continue。
- 页面再次显示所填邮件地址。用户确认无误,或点击 Change 进行修改。

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

链接格式与参数
用于销售游戏 Key 的链接格式如下:
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}
查询参数列表:
| 参数 | 描述 |
|---|---|
type | 商品类型。必填。 可选值:
|
project_id | 项目 ID,可通过以下位置查看:
必填。 |
sku | 游戏 Key 套餐的 SKU。必填。 示例:
为确保链接正常运行,可通过获取游戏列表 API 调用核对 SKU 值。商品 SKU 会在 |
xsolla_login_token | 通过艾克索拉登录管理器获取的用户身份认证令牌 (JWT)。详情参见向已认证用户销售。 |
access_data | 以 Base64 编码的 JSON 对象,包含用户数据和支付设置。详情参见向已认证用户销售。 |
auth | 通过支付收银台获取的用户身份认证令牌。详情参见向已认证用户销售。 |
ui_settings | 以 Base64 编码的 JSON 对象,包含用户界面主题设置。详情参见自定义用户界面。 |
mode | 传入 sandbox 值以进行测试支付。详情参见支付测试。 |
| 参数 | 描述 |
|---|---|
type | 商品类型。必填。 可选值:
|
project_id | 项目 ID,可通过以下位置查看:
必填。 |
sku | 游戏 Key 套餐的 SKU。必填。 示例:
为确保链接正常运行,可通过获取游戏列表 API 调用核对 SKU 值。商品 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 |
Steam 游戏销售 URL 示例:
- http
1https://purchase.xsolla.com/pages/buy?type=game_key&project_id=123456&sku=game456_steam
自定义用户界面
为使订单页面与游戏风格保持一致,请参照自定义说明配置主题、尺寸等参数。在链接中添加 ui_settings 参数,并将 settings.ui JSON 对象经 Base64 编码后传入其中。
使用自定义主题打开订单页面的 URL 示例:
- http
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对象)一致。
编码前的
- json
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 示例:
- http
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 示例:
- http
1https://purchase.xsolla.com/pages/buy?type={YOUR_ITEM_TYPE}&project_id={YOUR_PROJECT_ID}&sku={YOUR_ITEM_SKU}&mode=sandbox
发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。