Xsolla-logo
  • 文档
  • 创建帐户

使用指定商品创建订单

post/v2/project/{project_id}/payment/item/{item_sku}

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

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

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

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

注:

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

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 44056
item_sku
required
string

商品SKU。

Example: booster_mega_1
Request Body schema: application/json
currency
string

表示价格的货币(默认为美元)。符合ISO 4217的三字母货币代码。

custom_parameters
object [ 1 .. 200 ] properties

项目特定参数。

locale
string

响应语言。

promo_code
string

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

quantity
integer >= 1
Default: 1

商品数量。

sandbox
boolean
Default: false

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

object

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

payment_method
integer >= 1

付款方式ID。

object
delay
integer

经过指定延迟时间后自动将用户重定向到返回URL。

redirect_button_caption
string

本地化的重定向按钮文字。

redirect_conditions
string

触发将用户重定向到返回URL的支付状态。

Enum: "none" "successful" "successful_or_canceled" "any"
status_for_manual_redirection
string

触发显示重定向按钮的支付状态,用户单击该按钮后将被重定向到返回URL。

Enum: "none" "vc" "successful" "successful_or_canceled" "any"
return_url
string <uri> <= 1000 characters

用户会在支付过后被重定向到此页面。参数user_idforeigninvoiceinvoice_idstatus会被自动添加到此链接。

object

界面设置。

object

桌面版本的界面设置。

object

页眉设置。

close_button
boolean
Default: false

是否在支付中心桌面端显示关闭按钮。该按钮将关闭支付中心并将用户重定向到settings.return_url参数中指定的URL。默认为false

is_visible
boolean

页眉在支付UI上是否可见。

type
string
Default: "normal"

如何显示页眉。不能为compact(隐藏项目名称和用户ID)或normal(默认)。

Enum: "compact" "normal"
visible_logo
boolean

如果为true,标题中将显示Logo(请先把Logo文件提供给您的项目经理)。

visible_name
boolean

页眉中是否显示项目名称。

visible_purchase
boolean
Default: true

是否在页眉中显示购买描述(purchase.description.value)。默认为true

mode
string

支付中心的界面模式。可能的值为user_account。请注意,页眉仅包含用户帐户的导航菜单,而没有用于选择产品或进行付款的任何选项。“用户帐户”仅在桌面模式下可用。

Value: "user_account"
theme
string
Default: "63295a9a2e47fab76f7708e1"

支付UI主题。可以是63295a9a2e47fab76f7708e1(浅色主题(默认)),或63295aab2e47fab76f7708e3(深色主题)。您也可以创建自定义主题,然后在此参数中传入其ID。

Enum: "63295a9a2e47fab76f7708e1" "63295aab2e47fab76f7708e3"
object

用户帐户详细信息。

object
Default: "Page **My account**."
enable
required
boolean
Default: false

是否显示子菜单。默认为false

order
required
integer >= 1

子菜单在菜单中的位置。

object

我的支付帐户子菜单。

enable
required
boolean
Default: false

是否显示子菜单。默认为false

object

管理订阅子菜单。

enable
required
boolean
Default: false

是否显示子菜单。默认为false

order
required
integer >= 1

子菜单在菜单中的位置。

object

用户发货数据。

country
required
string^[A-Z]{2}$
address1
required
string
address2
required
string
address3
required
string
state
required
string
first_name
required
string
last_name
required
string
city
required
string
postal_code
required
string
region
required
string
phone
required
string^\+
comment
string
email
string
object

选择的送货方式。格式取决于集成的配送提供商。

property name*
additional property
any
Responses
200

订单已成功创建。

404

未找到商品或优惠券。请确保使用的数据正确无误。

422

无效错误。

Request samples
application/json
{
  • "custom_parameters": {
    },
  • "promo_code": "discount_code",
  • "quantity": 5,
  • "sandbox": true,
  • "settings": {
    }
}
Response samples
application/json
{
  • "order_id": 641,
  • "token": "f4puMEFFDZcx9nv5HoNHIkPe9qghvBQo"
}