使用指定免费购物车创建订单

post/v2/project/{project_id}/free/cart/{cart_id}

使用指定免费购物车中的所有商品创建一个订单。创建的订单将具有done的订单状态。

SecurityAuthForCart

Request

path Parameters

project_id required	integer 项目ID。 Example: 44056
cart_id required	string 购物车ID。 Example: custom_id

Request Body schema: application/json

currency

string

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

custom_parameters

object [ 1 .. 200 ] properties

项目特定参数。

locale

string

响应语言。

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_id、foreigninvoice、invoice_id和status会被自动添加到此链接。

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

成功创建免费订单。

422

购物车无效。请检查购物车是否存在，内容不能为空，并且其中的所有商品均非免费。

Request samples

application/json

{"custom_parameters": {"character_id": "ingameUsername"
},
"sandbox": true,
"settings": {"ui": {"desktop": {"header": {"close_button": false,
"is_visible": true,
"type": "normal",
"visible_logo": true,
"visible_name": true,
"visible_purchase": true
}
},
"theme": "63295a9a2e47fab76f7708e1"
}
}
}

Response samples

application/json

{"order_id": 641
}