When building a MiniApp for the GoPay ecosystem, it is important to follow industry-proven practices to ensure scalability, security, and seamless integration. The goal of a MiniApp is to provide a lightweight, fast, and reliable application that runs inside the GoPay Super App while leveraging GoPay APIs and SDKs for payments, authentication, and user services.
Below are the recommended practices for building and launching your MiniApp:
| Area | Best Practice | Why It Matters |
|---|---|---|
| Plan Your MiniApp | Define your MiniApp’s purpose (e.g., ordering, loyalty, booking), and what is the required APIs (login, payments, device features), and expected user traffic. | Helps GoPay allocate the right permissions and ensures smooth scaling. |
| Submit & Onboard | Fill in the MiniApp submission form and join the GoPay MiniApp Portal workspace. | Grants your team access to the tools and credentials needed for development. |
| Setup Project in Portal | Create a new MiniApp project in the GoPay MiniApp Portal and bind it with your local project. | Keeps your MiniApp registered and linked to GoPay for integration and version control. |
| Use GoPay Container SDK | Integrate login, payments, and native device features (camera, location, biometrics) through the SDK. | Delivers a native-like user experience and reduces development complexity. |
| Authentication Flow | Implement getAuthCode on FE and getAuthToken on BE using provided credentials. | Ensures secure and seamless login via GoPay account id without handling sensitive data. |
| Payments Integration | Use BI-SNAP one-time checkout: redirect to GoPay for payment, then back to MiniApp. | Provides a trusted, seamless payment experience while keeping security managed by GoPay. |
| Consistent UI/UX | Merchants can design their own UI while optionally using GoPay’s design patterns for login, payments, and navigation to keep user experiences consistent. | Builds user trust and makes the MiniApp feel native inside GoPay. |
| Test in Container | Validate login, payments, and error flows inside the GoPay container before publishing. | Prevents production issues and ensures a smooth experience. |
| Publish & Submit for Release | Package your MiniApp, upload it via the portal, and request release approval. | Keeps releases fast and avoids lengthy app store reviews. |
| Monitor & Improve | Track performance, payments, and user behavior via the GoPay platform analytics. | Enables continuous optimization and better business insights. |