你需要准备什么
- 拥有沙盒访问权限的 Nayax 开发者帐户（由 Nayax 在您完成注册后提供）
- 您可控制的托管 Web 应用程序（您的扩展程序在 Nayax Core 内部的 iframe 中运行）
- 熟悉核心扩展概述和扩展类型
核心扩展程序不支持自助注册。Nayax 会为您配置沙盒访问权限，并在 Nayax Core 中手动注册您的应用。请联系您的 Nayax 代表以开始注册流程。
1
获取沙盒访问权限
Nayax 会向您发送一封欢迎邮件，其中包含您的沙箱凭据和环境详情。该沙箱是一个完整的 Nayax Core 环境，您可以在其中对扩展程序进行端到端测试，然后再提交认证。获得访问权限后，请验证您是否能够通过欢迎邮件中提供的 URL 登录到沙盒 Nayax Core 实例。
2
选择您的主机方案
您的扩展程序以 Web 应用程序的形式运行，托管在 Nayax Core 以 iframe 形式加载的 URL 上。您可以将其托管在您自己的基础设施上，或者在某些情况下，托管在 Nayax 提供的基础设施上。将您的应用程序托管在可公开访问的 HTTPS URL 上。当您的应用程序在沙盒菜单中注册时，您需要将此 URL 提供给 Nayax。
3
实施所需的集成
在对扩展程序进行端到端测试之前，请实现应用程序框架要求的四个方面。Authentication: Receive the JWT token Nayax passes to your app at load time and use it for all Nayax API calls.Extension Types: Choose the display type that fits your use case (Screen, Fullscreen, Button with Popup, or Tab) and implement the matching token delivery method.Translations: Wrap all user-visible text in the translation function so Nayax Core can serve your UI in the user’s language.Role-Based UI Visibility: Register the UI elements your app exposes so Nayax Core administrators can control visibility by role.
4
在沙盒中注册您的应用
应用程序托管完毕且集成完成后，请向 Nayax 提供以下信息：
- 您的托管应用程序的 URL
- 您使用的显示类型（屏幕、全屏、带弹出窗口的按钮或标签页）
- 应用应显示的菜单位置
- 您的应用所需的权限范围（如有）
5
在沙箱中进行测试
应用注册完成后，以拥有菜单项访问权限的用户身份登录 Nayax Core 沙盒环境。验证：
- 您的扩展程序已加载到正确的 URL
- 您已收到有效的 JWT 令牌（请检查浏览器控制台或网络选项卡）。
- 使用该令牌发起的 API 调用返回预期数据
- 切换 Nayax Core 语言设置时，UI 文本会以正确的语言显示。
- 根据用户的角色，角色控制元素会正确地显示和隐藏。
6
提交认证申请
当您的扩展程序通过沙盒测试后，请联系 Nayax 申请认证。Nayax 会在批准您的应用上线前对其进行审核。
7
部署到生产环境
认证完成后，Nayax 会将您的应用注册到生产环境 Nayax Core 中。将您的应用部署到生产环境托管基础架构，并验证其是否能使用生产环境 JWT 公钥正确加载。有关生产环境公钥和令牌验证的详细信息，请参阅身份验证部分。
概括
您已完成核心扩展的完整生命周期：沙盒访问、实施、沙盒注册和测试、认证以及生产部署。接下来的步骤是使用以下指南详细实施每个技术领域。验证
接收并验证 JWT 令牌。
扩展类型
选择并实施合适的显示类型。
翻译
公开您的 UI 字符串以支持多语言。
基于角色的可见性
声明哪些 UI 元素可由角色控制。