This guide introduces GoPay Container, the runtime environment for MiniApps inside the GoPay app. It explains the differences between Container V1 and V2, their features, deployment models, and how they enable seamless login, payments, and native-like experiences for users.
What is GoPay Container V2
GoPay Container V2 (formerly known as WebKit Container) is a WebKit-based runtime environment where MiniApps are hosted externally by merchants and loaded into the GoPay app through a configured entrypoint URL.
Instead of uploading bundled builds into a portal, merchants deploy updates directly on their own infrastructure. This enables faster iteration, simplified deployment workflows, and better alignment with modern web development practices.
Key characteristics:
- Merchant-hosted MiniApp
- Faster loading performance
- Smaller application size
- Growing set of JSAPIs
- Recommended for new MiniApp integrations
GoPay Container V2 represents the evolution of the MiniApp platform, providing a lightweight and flexible architecture while still maintaining secure communication with GoPay services. The container acts as a secure runtime layer inside the GoPay app, allowing MiniApps to integrate authentication, payments, deeplinking, and frontend JSAPIs without requiring packaged uploads.
This approach reduces operational overhead for merchants while improving scalability, deployment flexibility, and long-term maintainability.
Key Features of the GoPay Container V2
Below are the features & capabilities you or your dev team can expect when using GoPay Container V2:
| Feature | What it does / why it matters |
|---|---|
| Hosted Web Entrypoint | MiniApps are hosted on your own public domain instead of uploading builds. This gives merchants full control over deployments, infrastructure, and release cycles. |
| Seamless GoPay Login | Supports integrated GoPay authentication flows, allowing users to access MiniApps without separate login steps, improving conversion and reducing friction. |
| Integrated Payment Support | MiniApps can trigger GoPay payment flows securely through standardized APIs and container capabilities without building native payment UI. |
| Frontend JSAPI Access | Provides access to native capabilities such as deeplinks, device interactions, and container communication through standardized frontend APIs. |
| Cross-Platform Runtime | Runs consistently inside the GoPay app on both iOS and Android, allowing teams to build once using web technologies. |
| Faster Iteration & Deployment | Since MiniApps are externally hosted, updates can be deployed instantly without uploading new builds through the portal. |
| Deeplink & Parameter Support | Supports MiniApp deeplinks with parameters, enabling content segmentation, campaigns, and dynamic user journeys. |
| Improved Scalability | Public domain hosting allows merchants to scale infrastructure independently while still leveraging GoPay’s container ecosystem. |
| Standardized Security Model | Maintains secure communication between the MiniApp and GoPay through predefined authentication and container protocols. |
| Analytics Integration | Merchants can define and trigger events in their miniapps, while we automatically track default events for GoPay analytics insights. |
Key Characteristics
- Uses a public MiniApp URL as the entrypoint.
- Merchants manage hosting, updates, and deployments.
- Supports custom JSAPI integrations for device features.
- Changes deployed on your server are reflected immediately in production.
Advantages
- Easier and faster integration.
- Faster loading time and smaller application size.
- No packaging or publishing flow required.
- Ideal for teams already familiar with modern web development.
Considerations
- Functionalities are currently more limited compared to V1 (subset of FE SDKs available).
- No versioning or staged release — updates go live instantly.
- Data is passed through URLs, requiring careful security implementation.