一般信息
SDK支持一键购买或通过购物车购买目录中的商品。
要测试购买过程,可使用支付UI的沙盒模式和测试银行卡进行。沙盒模式只模拟支付方式的行为,不涉及真实支付。使用沙盒模式无需与艾克索拉签署任何协议或支付任何费用。
支付UI基于支付中心产品。可用支付方式的选择以及其他设置在发布商帐户的支付中心部分提供。
支付UI的打开方式取决于应用程序针对的平台:
- 对于桌面应用程序,SDK允许在内置浏览器或外部浏览器(具体取决于项目设置)中打开支付UI。
- 对于移动应用,支付UI在外部浏览器中打开。
- 对于WebGL,支付UI小组件在同一浏览器页面的iframe中打开。
在移动应用中,如在WebView中打开支付UI,请添加一个按钮以便用户可以在购买过程的任意阶段关闭支付UI。方法是调用XsollaCatalog.Purchase
或XsollaCart.Purchase
SDK方法时在PurchaseParams
类的实例上使用close_button
参数。
您可以选择显示在按钮上的图标,方法是在PurchaseParams
类的close_button_icon
参数中传入以下值之一:
“arrow”
— 显示←图标(默认使用)“cross”
— 显示×图标
在WebView中使用close_button参数和close_button_icon的示例:
详解
要在用户完成支付后将其重定向到其他页面,有两种重定向方式可以配置:
- 自动 — 根据指定延迟时间重定向。
- 手动 — 用户点击跳转按钮后发生重定向。
您可以通过以下方式配置重定向:
- 在发布商帐户中配置 — 如果您是一个应用程序设置一个项目且不打算为不同平台创建不同编译版本,请使用此方式。
- 在SDK设置中配置 — 如打算进行以下操作,请使用此方式:
- 为多个应用程序使用同一个项目
- 为不同平台创建不同编译版本
- 通过网站销售游戏内商品
在发布商帐户中配置重定向
- 在发布商帐户中打开您的项目。
- 在侧边栏中单击支付中心。
- 前往设置 > 重定向政策部分。
- 在返回URL字段中,输入用户支付后将其重定向到的URL或路径。
要将用户重定向到一个移动应用程序,URL必须符合以下机制之一:
app://xpayment.<ANDROID_PACKAGE_NAME>
,其中<ANDROID_PACKAGE_NAME>
是Android应用的包名称。app://xpayment.<BUNDLE_ID>
,其中<BUNDLE_ID>
是iOS应用标识符。
<ANDROID_PACKAGE_NAME>
/<BUNDLE_ID>
值可以在Unity项目设置中找到(
- 要设置自动重定向参数:
- 在下拉菜单列表中,选择自动重定向条件:
- 无 — 不重定向。
- 成功支付 — 支付成功后发生重定向。
- 成功或已取消 — 支付成功或取消支付后发生重定向。
- 任何支付 — 任何支付状态都发生重定向。
- 在延迟字段,输入以秒为单位的重定向超时时间。默认情况下,重定向在被激活后0秒发生。
- 在下拉菜单列表中,选择自动重定向条件:
- 要设置手动重定向参数:
- 在下拉菜单列表中,选择手动重定向条件:
- 无 — 不重定向。
- 成功支付 — 支付成功后显示重定向按钮。
- 成功或已取消 — 支付成功或取消支付后显示重定向按钮。
- 任何支付 — 任何支付状态都显示重定向按钮。
- 在重定向按钮文字字段,输入将用户重定向到返回URL的按钮文字。
- 在下拉菜单列表中,选择手动重定向条件:
重定向按钮的默认文字是返回游戏。该文字已翻译为所有支付中心语言。
如果您的项目项目支持多个语言,您可以在相应字段中为每个语言指定重定向按钮文字。
用户关闭支付UI后,他们也将被重定向到指定的返回URL。
- 单击保存。
在SDK设置中配置重定向
- 打开您的Unity项目。
- 在主菜单中单击
Window > Xsolla > Edit Settings 。 - 打开
Inspector 面板并前往Pay Station > Redirect Policy 部分。 - 根据应用程序的编译版本平台(
Desktop 、WebGL 、Android 或iOS )前往相应部分,并指定以下重定向参数:
- 取消勾选
Use setting from Publisher Account 复选框。 - 在
Return URL 字段,输入用户支付后将其重定向到的URL或路径。
- 取消勾选
要将用户重定向到一个移动应用程序,URL必须符合以下机制之一:
app://xpayment.<ANDROID_PACKAGE_NAME>
,其中<ANDROID_PACKAGE_NAME>
是Android应用的包名称。app://xpayment.<BUNDLE_ID>
,其中<BUNDLE_ID>
是iOS应用标识符。
<ANDROID_PACKAGE_NAME>
/<BUNDLE_ID>
值可以在Unity项目设置中找到(
- 要设置自动重定向参数:
- 在下拉菜单列表中,选择
Redirect Conditions :None — 不发生重定向。Successful payment — 支付成功后发生重定向。Successful or canceled payment — 支付成功或取消支付后发生重定向。Any payment — 任何支付状态都发生重定向。
- 在
Redirect Timeout 字段,输入以秒为单位的重定向超时时间。
- 在下拉菜单列表中,选择
- 要设置自动重定向参数:
- 要设置手动重定向参数:
- 在下拉菜单列表中,选择
Status for Manual Redirection :None — 不发生重定向。Successful payment — 支付成功后显示重定向按钮。Successful or canceled payment — 支付成功或取消支付后显示重定向按钮。Any payment — 任何支付状态都显示重定向按钮。
- 在
Redirect Button Caption 字段,输入将用户重定向到返回URL的按钮文字。
- 在下拉菜单列表中,选择
- 要设置手动重定向参数:
重定向按钮的默认文字是返回游戏。该文字已翻译为所有支付中心语言。
如果您的项目项目支持多个语言,您可以在相应字段中为每个语言指定重定向按钮文字。
用户关闭支付UI后,他们也将被重定向到指定的返回URL。
继续阅读
上次更新时间: 2024年7月23日发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。