Introduction

There is two types of container available which is being used to integrate to GoPay as a MiniApp

1. 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.
2. GoPay Container V1 (formerly known as GoPay Container SDK) is a bundled WebView-based environment where MiniApps are uploaded, versioned, and released through the MiniApp Portal.

Migration Paths

• Webview (Deprecated) → GoPay Container V2
• GoPay Container V1 → GoPay Container V2
• GoPay Container V2 → GoPay Container V1

Note: Before planning for migration please check the list of existing frontend sdk and make sure it's available since not all handler are presents.

• Webview (Deprecated) → GoPay Container V2
• GoPay Container V2 Frontend SDK
• GoPay Container V1 Frontend SDK

Quick Start

1. Complete the Mini App Onboarding Submission and select Migration to Another Platform to begin.
   1. Webview (Deprecated) → GoPay Container V2
   2. GoPay Container V1 → GoPay Container V2
   3. GoPay Container V2 → GoPay Container V1
      Prerequisite: Onboard to GoPay MiniApp Portal to Create New MiniApp Project and input your Miniapp ID
2. If the MiniApp is Live, GoPay team will temporarily remove the MiniApp.
3. Tech support will inform the merchants regarding the migration completion and the updated deeplink
4. Merchants to do adjustments using the updated deeplink
   1. Webview (Deprecated) → GoPay Container V2
   2. GoPay Container V1 → GoPay Container V2
   3. GoPay Container V2 → GoPay Container V1
5. If the MiniApp is Live, QA to validate once development are completed and our rollout team will update the deeplink and rollout back the MiniApp

Webview to GoPay Container V2 adjustments

1. Update FE JSBridge from npm to script
2. Adjust the handler request and response to use the updated GoPay Container V2 Frontend SDK
   1. Update response from snake_case to camelCase
3. For more information please check the V2 getting started page

GoPay Container V1 to GoPay Container V2 adjustments

1. Remove the extension and use SDK Script
2. Adjust the handler request and response to use the updated GoPay Container V2 Frontend SDK
3. For more information please check the V2 getting started page

GoPay Container V2 to GoPay Container V1 adjustments

1. Remove the SDK Script and use extension
2. Adjust the handler request and response to use the updated GoPay Container V1 Frontend SDK
3. Additional setup:
   1. Project Initial Setup
   2. Publish your MiniApp
   3. How to Test MiniApp
4. For more information please check the V1 getting started page