支付配置
用户验证
用户ID是什么？
用户ID是用于识别游戏中用户身份的参数。可将用户ID保存在数据库中。收到无效的用户ID时，可抛出意外错误。关于用户验证的示例，请参阅GitHub存储库。
完成验证后应返回什么数据？
验证成功后，返回HTTP代码200。如发生错误，则返回代码400 (INVALID_USER)。
定制化
可以自定义支付UI主题吗？
您可以在令牌中发送settings.ui.theme = default_dark参数启用深色主题。深色主题允许您设置背景图片或更改背景颜色（如演示所示）。如需更改其他设置，请联系您的客户成功经理或发送邮件至csm@xsolla.com。
可以更改发送给用户的邮件的外观吗？
可以。请按照如何自定义给用户的邮件的说明进行操作。电子邮件元素的顺序是标准模板的一部分，因此无法更改。根据与艾克索拉签订的许可协议，这一做法是必需的，因为艾克索拉是法律上的在册商户。
测试
可以使用测试银行卡来测试支付过程吗？
可以，但仅限于在沙盒模式下运行您的应用程序或支付中心演示的情况。请参阅不同平台不同发卡国家/地区测试银行卡的通用列表。
可以在沙盒模式下测试PayPal支付流程吗？
是的，请在说明中查看详细信息。
如何测试退款过程？
您可以通过请求退款API调用来测试退款。详细信息请参阅说明。
发布商帐户Webhook测试选项卡中的“艾克索拉发票ID”和“发票ID”是什么？
艾克索拉发票ID是艾克索拉侧的交易ID。测试时可填写任意数值。
发票ID是您游戏中的选填交易ID。测试时可使用任意字母数字的组合。
支付
如何验证webhook中收到的支付请求？
首先，检查指定用户ID是否在项目中存在。然后，返回200代码验证支付。
可以将用户重定向到特定支付方式吗？
打开商店UI时，您可以在settings.payment_method参数中传入支付方式ID。此情况下，用户将被重定向到所选支付方式的支付表单。您可以在发布商帐户的付款 > 付款方式部分找到支付方式ID。
支付处理完毕后，是否可根据结果自动将用户重定向到支付成功/失败页面？
可以，您可以配置重定向条件。详细信息请参阅说明。
我们的账单系统会自动设置每个订单的order_id。那么收到令牌时是否可使用order_id而不是user_id？
不能，必须使用user_id一切才能正常运行。
您可以在external_id参数中额外传入order_id。操作方法：
- 在发布商帐户中打开您的项目，前往项目设置 > 集成设置部分。
- 勾选使用外部ID复选框。
- 单击保存。
是否可覆写各交易的webhook URL？
不可以，所有交易的webhook URL需在发布商帐户的项目设置中进行设置。
我会收到失败交易的详细信息吗？
不会，艾克索拉只发送成功交易的webhook。如果您收到了一个支付通知，说明该交易是成功的。
如何将增值税加入总支付金额中？
默认情况下，增值税设置在艾克索拉侧配置。如要更改该设置并将增值税加入用户的总付款金额中，请联系您的客户成功经理或发送邮件至csm@xsolla.com。PID代表什么？
PID是艾克索拉侧的付款方式标识符。
什么是外部ID？
外部ID是在您的系统中分配给订单的游戏交易ID。在艾克索拉侧，外部ID与交易ID关联，因此启用的外部ID可以让艾克索拉防止对同一交易重复付款。
“external_id”: “1”，那么就不能使用“external_id”: “1”进行真实付款。- 在发布商帐户中打开您的项目，前往项目设置 > 集成设置部分。
- 在付款部分，勾选所需复选框：
- 使用外部ID — 创建令牌时需要验证外部ID。
- 跳过外部ID验证 — 创建令牌时禁用外部ID验证。
- 单击保存。
启用使用外部ID设置后，您将无法通过发布商帐户进行测试支付。如要进行测试支付，请暂时禁用此设置。
每笔交易是否都需要生成新的外部ID？
是的，每笔支付的外部ID必须是唯一的。
对于setExternalPaymentId方法需要设置何值？
setExternalPaymentId方法的值应与external_id一致（如有）。
什么是直接帐户？
与支付系统签订协议后，即可用直接帐户在支付UI中显示这些支付选项。玩家仍可通过所选支付方式支付购买物，您将直接从这些支付系统提供商收到付款。要连接直接帐户，请在发布商帐户中打开您的项目，然后前往付款 > 支付设置 > 直付通道部分。
艾克索拉作为技术服务提供商提供此服务并收取一笔极低的收入分成：交易金额的1.25% + 0.10美元。您可以使用所有艾克索拉解决方案的完整功能，但必须自行负责以下事项：
- 管理税务相关事宜
- 与各支付系统签订单独协议
- 留存从各支付系统获得的直接现金流
- 管理支付系统费用、拒付、退款、提现手续费及运营费用等
例如，如您使用PayPal并希望将其设置为直接支付方式，您可以连接一个直接帐户。支付UI将不会改变，仅影响提现过程。支付完成处理后，玩家的钱将转入您的PayPal帐户。此例中，艾克索拉不会参与提现过程。
如何将用户数据（保存的付款帐户信息、订阅等）迁移到艾克索拉？
请联系您的客户成功经理或发送邮件至csm@xsolla.com。请务必使用PGP加密以确保安全性。
艾克索拉PGP密钥参数：
- 密钥ID：DA1E62CB
- 密钥类型：RSA
- 密钥长度：4096
- 指纹：0209 8489 757F 4451 F431 FB0C FBFC 4D97 DA1E 62CB
- 用户ID：admins@xsolla.com
1-----BEGIN PGP PUBLIC KEY BLOCK-----
2
3mQINBGnZA+8BEACtu+pO73jhG/5sjmkJRpMxftcQeNZRpB1QUMYYNcB6MFVuU3Oo
4HO/hOuXWIbh1S5LWQOok5cY3eiQOKwjhwV/IpM0DJ5pxi5YlCAHwkSWO4b2J4lXF
5pu27bb9whbaC+V1g1gE0TmLtiqKfX0QF6NZop4SrQ3f4yDoV50JKHGtW9XWL4Bfz
6JWNyM9H4PFdzy5Pwhu5/642XSZf9MClpQzUjwPw+zSfxnweF6je3lbWvH+2fqBG/
7Y1SeMuFW9Vo9QNCdBX9ws98CrS9bN3frXywh6B1cEEVoBbOvH/T3foKUmlr5gdHi
8ijTKiFKHTsBcfHcaQgM1cCD0qrRCLrQ2j6KjJOjRevHLJLzdmZFiCDD11+eL338k
9o4GVdoQR4aNeXfJEICN+79kwz/AVa6d8O934Nnfbz7e7Xx10KR/ObLt6Xnp57GmE
10zWqvtkJ/GGivCyyHR632Nb4yoj/lgf6s0Z0oTQ4Dx8u+as2T+OG+zNo4xRcU8fE2
11F2FBbYXtzp6ySrWu0YcOjS+YhH5tjJBz1dndEQ+FwfA9MWmQgNDuHfdub0CcQqb2
12AfipbGzU+cPucmiyown1WzqP824xmr2JOVJ28DD8CkuAtGQW+kGQqZzHohWgM5WS
13nZlX6rfIYtrygJFrbULGb7A4Ekj9IDzUjnpiHSf8D1jtcHPNPZ2zRvrC3wARAQAB
14tCFYc29sbGEgQWRtaW5zIDxhZG1pbnNAeHNvbGxhLmNvbT6JAlQEEwEIAD4WIQQC
15CYSJdX9EUfQx+wz7/E2X2h5iywUCadkD7wIbLwUJAeEzgAULCQgHAgYVCgkICwIE
16FgIDAQIeAQIXgAAKCRD7/E2X2h5iyxvVD/wLxBbYrNLPuEAJwL8UWDu1naQuaZHl
17/6yDUBV70l7Cxla6KEUqipuJDeD+Vgn85CqVui9eHgZpgXSxG5WogtO+Fkw3n/Ww
18gJkbZQTufWCuW/A82+aHaD0GNCLYqV6EEHQQ4hko6Z3E3zuuI0EoP9hB1BgUq0W1
19qhwrb1Q6Y8nQMgmhCgoRC8EvVFQwk6isvxDczym02/edjxgWuDZJOmZ5WMeN3Vzz
20QoYaGuChoyemigwGvJBKJKAMlgCRZNKlX7L3fOebT16jq1i5ByUqmmngq3YnBnmv
21j76HXP+MQioVr1FC4lkTkD4wWAw/l0gO0B3zLbPY8KQO4gcfLdH6wWPsfcQDmYWK
221vT9AhSPcIQCEcPCZnDBsf6FbiO3KMp0mFCJ0dZdaRJrem/7eL+P3I//H3HKo8RR
23BBGHJZCcm6MSwztUxZW2+6YiMCP9oQVU2zRnUfl/+J6maj83vz9cFQEqYyhbKjTu
24kRkAowUUA54GXnmul+sCvuJXHoKeC4EyZzNYCDxd9Y2u0jAnng2qT09b66IguOZW
250FPSzsRSeHGigwcK+/ChLk0+1CTXmO1fweIsaE1RcqgNLCR4Drtpup2Be8PA3B7i
26Uu8hDz77Lzz8M4O7jDUpS+plUrJEJ1dY+Uiav8jvkeqT9wc89jwKHxNUFNiPhFRb
27cSPnPI9I1QziyLkCDQRp2QPvARAApfXCw+EkrxXY+kOC/WKTen5Z/5hsTlupq2XR
28uF9S//LzVmgPXuVHqMUWUoNs/nfRLwDbJ7CjygL1DKMDSBzPkovaLOhnr4EMvmsP
29CUgQPXP0YUpSYBkAe5idrK2RPegNe68+wEz5r6azHS9r1QjSy+ekXGdTMrAs/On2
30FxxMLWYrEJ8M8iBDQVVOOK8YowcNV44U+ljf5VkJ8TpdNXOATLxuhNXvYTzuDGi6
31J0XCMa3CkIzxC3E4U2qWrHOjU7DjsvqiL5PbtiHjHhCoS6emdPsvqViaIafzcuE5
32eAGiHMyLRl5uwSdAmuW04W+IPM1PM3lwFjFB2lM2f1qHTJXZvG6mXYcBZgrA25te
33dRBgGgpofXutem0jM1lMDLzhAYHhAw8/uJR8yrq2A6t+rIDa1RxP8WJzLASG9rn/
34NmEgor27yhC2RIX4GwJsJ5xSCRkQPxbllVYCVpB6nFfTORbkaWdo7LSwXzUjrJBG
35++m4zQ+rcKRx9XjErls/hYXPB0tZXOP6vYM1zTLqAKtRPeQxJPK5/TbWrVgphvSi
36Yu6qMfnp2IYfyr1Zv0QjxvMUS/A9yVoH1ObY2SJDTa2Wtz1zBX76+vGj4FfeMn2C
37ROIzdvt9ndSYRk2bu/7XtflG7HomE9a/ATqOHalmLykLDgfsQLhSyLKnhOq7MmQw
38ZaQt7hkAEQEAAYkEcgQYAQgAJhYhBAIJhIl1f0RR9DH7DPv8TZfaHmLLBQJp2QPv
39AhsuBQkB4TOAAkAJEPv8TZfaHmLLwXQgBBkBCAAdFiEENKTXmM5UXELlwc4NJVnA
40zu7wAJMFAmnZA+8ACgkQJVnAzu7wAJOsLQ/9Fr7qfXD4EHX/IBrtLvhFiFRoQsUQ
41wp0aI8N2UrGfcWjRCHg7qdYfS5jZTuntNQQIHkVjs3Uqy9K06Va5pbJGCAQv50MW
42qZVKKGuaJ0aM2BsgEzCIIZYAcJpQilcU16A7FIUETMcE7HbubfD6NRW3DDYTBMLd
43Jn9idvd7bRmYCQuCwDMnLfa9JFjt+paCuySUfyCDvFqnO6EXIYQd2JFYptECFEkQ
44crZEfFlA5ygrpUSCsf5lDHgykoVziLbnW1R25dv84OV/Xu3hsjJFAY/TPP1Nh8M6
45JqZjGz5kOcIRThmT28jZdfgeqOnwIAc3rnr4B3NiXuuIJawfltnV5ujmnipcKLK8
46wPJlUAMcCOg3UD5tXjGwPBU8ryHkAZfXsqcUDllA7bGCRMPnQtfTnAr7xrieCjfn
47FDElBPsSg5C2jV9E23/n7+M0MuL/73fYGe8tDleEQHwyRbTEmI+5v4gwt1IOUlg7
485znJdXkp/Kwhmgv4GnFTB78pD+lx3CB0vPFsufhATCY8lDP+xMvUeURDF6jhGP/F
497waM/sOh9/zd4RaOxHMxGZHNs7g9rVca2AbwCTKuTvV7blUz10/j80prEyJwNj5e
50n+td7m4xLHRhSYeSXMteXIowWPE1nshYpV5sZbywE8pOwzBXbqHoNClDQh5szyFB
51CyHQR8sowp+42FLUFw/+PdDSjmI7/Z3vmtRsi+VgqbDM7CW2T8rIR/sUizBOCRah
52mBM1aA7IyJ2GerdMFGVeCRcCljUEiGnw+IvPdS72bTpfvk+8fU2o7PXsQSJfmhQS
53cA4k9uhLm87S3Ng5SX50+qTsgZgc7qywoSqCs4KC7p5zmsc+hfmdpFFmBYTP24Ai
54WdCXt1fqAAsbbO9dU5mos2Hs/L6qANKaN0wJBwf/cRnrewdV6zVhLCvkDYuXADf8
55SmgzXCESVNZNEFLWC2+syl3McSaRbjaInf1ijB8oMI7zR32bonqTEw4Vxc+mcc7H
56ck3ZtYyE8iA8TU5yyNzv0bmD5b8S7EquXekhbckC6tZw/i+O6xt6sZNnczkGbvup
57v5MNf4h8bcCkMFZ1jD27wpLUyGbxyr9t0D4DJeDYaAIyDF2IWd4kAeHvUyRvJt+b
58mbDI6b00PHMlW5JGebVvaV5opeBn2/aYTAMg5T7ohHxksM6jWfIVJPMRTik6RsGC
5937yLy8U7gcxebRwty6GxZuDdRjaBz/JcC9TshTgvbWJ392t8O3ZU6mezV2yDHTAO
60dE30NoqxiX+sZTYsyL5hkSW44LiH5sd30HxyXLQQ1Q+k3y0drKbp9UNc3E79l/mX
61r6jr1egiuYyCUk2zjaUx+UfI7Xrk2uttanFgJsTTX2wIGic5iFEecfe45V/YgOM=
62=naL7
63-----END PGP PUBLIC KEY BLOCK-----
如何判定用户的国家/地区？
使用生成支付令牌的客户端侧API调用时，艾克索拉根据请求的IP地址判定用户的国家/地区。
使用生成支付令牌的服务器侧API调用时，根据以下检查顺序判定国家/地区：
- 请求正文中
user.country.value参数的值 X-User-Ip头中的IP地址
如上述值均未传递，则显示错误。如果两个值都存在，则使用请求正文中的信息。
发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
