设置商品购买

在应用程序服务器侧创建订单

要使用用户和商品数据在艾克索拉侧创建订单，请使用为购买创建支付令牌API调用。该方法将返回一个支付令牌，用于打开支付UI并进行支付。要使用沙盒模式，请在获取令牌请求的正文中传入“sandbox”: true参数。

限制：

您需要在请求支付令牌时传入用户国家/地区或用户IP地址。系统使用这些数据来决定订单货币、支付界面的本地化语言以及计算税费。
如未在令牌中传入货币，则由国家/地区决定。
如在令牌中传入了货币，则用户用该货币进行支付。
在user_id参数中，您需要传入您用户认证系统中的用户ID。该ID用于在下单前验证用户。测试时可在该参数中传入任意字符。

默认情况下，令牌有效期是24小时。如要更改该值，请联系您的客户成功经理或发送邮件至 csm@xsolla.com。新值将对您公司在发布商帐户中创建的所有项目启用。

打开支付UI

此支付UI打开方式不支持销售游戏密钥。要销售游戏密钥，请按照说明进行操作。

示例：异步脚本加载

Copy

Full screen

Small screen

<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

Pay Station Embed允许通过postMessage获取支付UI事件。您可以将事件发送到分析系统。如要在分析系统中设置事件处理，请联系您的客户成功经理或发送邮件至 csm@xsolla.com。

艾克索拉团队创建了一个小组件，帮助您简化将支付UI集成到网站的过程。小组件脚本在我们的GitHub存储库中提供。

用于脚本初始化的参数列表：

参数	类型	描述
access_token	string	令牌，通过API接收。必需。
sandbox	boolean	设置为`true`以测试支付流程，将使用`sandbox-secure.xsolla.com`而不是`secure.xsolla.com`。
lightbox	object	带有选项列表的对象，可用于打开lightbox（桌面版本）。
lightbox.width	string	Lightbox框架的高度。如果为`null`，则取决于支付中心的高度。默认值为`null`。
lightbox.height	string	Lightbox框架的高度。如果为`null`，则取决于支付中心的高度。默认值为`100%`。
lightbox.zIndex	integer	控制垂直堆叠顺序的属性，默认值为`1000`。
lightbox.overlayOpacity	integer	小组件背景的不透明度（`0` — 完全透明，`1` — 完全不透明）。默认值为60% (`.6`)。
lightbox.overlayBackground	string	浮层背景色，默认值为`#000000`。
lightbox.modal	boolean	如为`true`，lightbox框架不可关闭，默认值为`false`。
lightbox.closeByClick	boolean	如为`true`，单击浮层将关闭lightbox，默认值为`true`。
lightbox.closeByKeyboard	boolean	如为`true`，按ESC键将关闭lightbox，默认值为`true`。
lightbox.contentBackground	string	框架的背景，默认值为`#ffffff`。请注意，颜色更改不会影响支付中心iframe本身，只会影响容纳iframe的灯箱的设置。
lightbox.contentMargin	string	框架边距，默认值为`10px`。
lightbox.spinner	string	加载指示器的动画类型。可为`xsolla`或`round`。默认值为`xsolla`。
lightbox.spinnerColor	string	旋转加载动画的颜色，非默认设置。
childWindow	object	支付中心UI所在子窗口的选项。适用于移动版本。
childWindow.target	string	指定打开支付中心窗口的位置，可以是`_blank`、`_self`、`_parent`，默认值为`_blank`。

脚本使您可以跟踪支付UI发生的事件。根据事件的类型，可以在网页上执行各种操作。

事件列表：

参数	描述
init	小部件初始化事件。
open	打开小部件时的事件。
load	已加载支付UI（支付中心）。
close	已关闭支付UI（支付中心）。
status	用户在状态页面上移动时的事件。
status-invoice	用户在状态页面上移动但支付尚未完成时的事件。
status-delivering	用户在状态页面上移动，支付完成以及我们正在发送支付通知时的事件。
status-done	用户在状态页面上移动且支付已成功完成时的事件。
status-troubled	用户在状态页面上移动但支付失败时的事件。

如要初始化支付UI的打开，请使用以下链接：https://secure.xsolla.com/paystation4/?token=TOKEN。

打开支付UI的链接只能使用https://前缀。

如要进行测试，请使用以下URL：https://sandbox-secure.xsolla.com/paystation4/?token=TOKEN。

access_token参数包含隐私用户数据。请确保获取该参数时使用服务器对服务器通信。

进行测试性支付

要测试支付过程，您可以使用沙盒模式。沙盒模式是一个独立环境，支持除真实付款和拒绝支付外实时环境的所有功能。创建订单后，您可以通过发送“sandbox”: true来进入沙盒模式。

与艾克索拉签订合约之前，测试支付过程仅在沙盒模式下可用。

测试不需要从真实银行账户中扣款。

在沙盒模式下打开支付UI。
选择银行卡付款方式。
输入银行卡详细信息。对于其他字段（如名称或地址），可输入任意数据。您也可以指定不正确的细节（卡号或到期日）以测试是否会产生错误。
单击支付。

测试银行卡列表

查看测试银行卡列表。

如符合以下条件之一，除卡片详细信息外，还需指定邮政编码：

用户所在国家是美国或加拿大。
发卡行识别码(BIN)显示该卡的发行地在美国。

您可以指定任意有效的邮政编码（如12345）。该信息用于决定销售税税率，不影响测试付款过程。
沙盒模式下的银行卡付款支持以下货币：USD、EUR、RUB、GBP、AED、ALL、AMD、ARS、AUD、AZN、BGN、BRL、BYN、CAD、CHF、CLP、CNY、COP、CZK、DKK、DZD、EGP、GEL、HKD、HRK、HUF、IDR、ILS、INR、ISK、JPY、KES、KGS、KRW、KZT、MAD、MDL、MKD、MNT、MXN、MYR、NGN、PEN、PHP、PKR、PLN、RON、RSD、SAR、SEK、SGD、THB、TRY、TWD、UAH、UYU、UZS、VEF、VND、ZAR。

在沙盒模式下，您可以使用银行卡和PayPal测试一次性付款和通过保存的支付方式付款。

要查看沙盒模式下所作的交易：

打开您的发布商帐户。
前往会计 > 交易登记表。
勾选显示测试交易复选框。

您的进度

上次更新时间: 2024年9月4日

发现了错别字或其他内容错误？请选择文本，然后按Ctrl+Enter。

Your browser is not supported. Please try a different browser

付款

设置商品购买

在应用程序服务器侧创建订单

打开支付UI

access_token

sandbox

lightbox

lightbox.width

lightbox.height

lightbox.zIndex

lightbox.overlayOpacity

lightbox.overlayBackground

lightbox.modal

lightbox.closeByClick

lightbox.closeByKeyboard

lightbox.contentBackground

lightbox.contentMargin

lightbox.spinner

lightbox.spinnerColor

childWindow

childWindow.target

进行测试性支付