跳转到内容
/
使用指定商品创建订单

Digital Distribution Hub (1.0.0)

概览

Digital Distribution Hub是一个全新的艾克索拉解决方案，旨在通过推送支付(Push payments)技术和电子商务来联结数字与现金支付。

本参考指南合并介绍了用于以下两个艾克索拉产品的API端点：游戏内商店和支付中心。基础URL有两个：

  • https://store.xsolla.com/api ，用于常用、目录、购物车和订单组。
  • https://ps.xsolla.com，用于通知组。

目录组中的API端点不需要授权。

要使用购物车和订单组中的操作，需通过创建用户令牌来生成一个令牌。

注：

本参考展示的是未来可能的API设计，并非已经完全运作的界面。目前只支持尝试目录和通知组端点。如想向我们提供反馈，请发送邮件至techdoc@xsolla.com。
下载 OpenAPI 描述
index.json
index.yaml
语言
服务器
Mock server
https://xsolla.redocly.app/_mock/zh/api/digital-distribution-hub/
https://store.xsolla.com/api/

购物车

操作

游戏密钥

操作

虚拟物品和货币

操作

捆绑包

操作

用户令牌

操作

通知

操作

订单

操作

使用指定购物车中的所有商品创建订单

请求

使用指定购物车中的所有商品创建订单。创建的订单将获得new订单状态。

安全
AuthForClient
路径
project_idinteger必需

项目ID。

示例: 44056
cart_idstring必需

购物车ID。

示例: custom_id
正文application/json必需

包含订单创建数据的对象。

currencystring(Cart-Payment_settings_currency)必需

首选支付币种。参照ISO 4217标准的三字母货币代码。

geotypenumber必需

艾克索拉侧的分发合作伙伴ID。

示例: 13038
quantityinteger

商品数量。

示例: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/zh/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/cart/custom_id \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

响应

订单已成功创建。

正文application/json
billing_infoobject(Order_inline_response_200_billing_info)

账单信息。

order_idinteger

订单ID。

响应
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}

使用指定商品创建订单

请求

使用指定商品创建订单。创建的订单将获得new订单状态。

安全
AuthForClient
路径
project_idinteger必需

项目ID。

示例: 44056
item_skustring必需

商品SKU。

示例: booster_mega_1
正文application/json必需

包含订单创建数据的对象。

currencystring(Cart-Payment_settings_currency)必需

首选支付币种。参照ISO 4217标准的三字母货币代码。

geotypenumber必需

艾克索拉侧的分发合作伙伴ID。

示例: 13038
quantityinteger

商品数量。

示例: 1
curl -i -X POST \
  https://xsolla.redocly.app/_mock/zh/api/digital-distribution-hub/v2/project/44056/distribution_hub/payment/item/booster_mega_1 \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "geotype": 13038
  }'

响应

订单已成功创建。

正文application/json
billing_infoobject(Order_inline_response_200_billing_info)

账单信息。

order_idinteger

订单ID。

响应
application/json
{
  "billing_info": {
    "direct_taxes": [ … ],
    "indirect_taxes": [ … ],
    "price": { … }
  },
  "order_id": 641
}