跳转到内容

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/

购物车

操作

游戏密钥

操作

虚拟物品和货币

操作

捆绑包

操作

用户令牌

操作

通知

操作

取消通知

请求

在以下情况下发送支付取消通知：

  • 支付未完成
  • 支付已退款
正文application/json
payment_idinteger必需
curl -i -X POST \
  https://xsolla.redocly.app/_mock/zh/api/digital-distribution-hub/push-payments/cancel \
  -H 'Content-Type: application/json' \
  -d '{
    "payment_id": 784998479
  }'

响应

确定。

支付通知

请求

成功向用户扣款后发送此通知。

正文application/json
paymentobject必需
payment.​amountnumber必需

付款金额。

payment.​currencystring

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

payment.​geotype_idinteger必需

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

payment.​project_transaction_idstring

游戏开发者侧的交易ID。

payment.​ps_transaction_idstring

分发合作伙伴侧的交易ID。

project_idinteger必需

项目ID。

purchaseobject必需
purchase.​order_idinteger必需

订单ID。

userobject必需
user.​emailstring

用户邮箱地址。

user.​idstring必需

游戏中的唯一用户标识符。

user.​phonestring

用户手机号码。

user.​ps_account_idstring

分发合作伙伴侧的用户支付帐户ID。

curl -i -X POST \
  https://xsolla.redocly.app/_mock/zh/api/digital-distribution-hub/push-payments/pay \
  -H 'Content-Type: application/json' \
  -d '{
    "payment": {
      "amount": 10,
      "currency": "USD",
      "geotype_id": 13038,
      "ps_transaction_id": "ps_transaction_id"
    },
    "project_id": 18404,
    "purchase": {
      "order_id": 1334430
    },
    "user": {
      "id": "s.ivanov"
    }
  }'

响应

确定。

正文application/json
payment_idinteger
响应
application/json
{
  "payment_id": 784998484
}

订单

操作