Testing MiniApp V1

There are four ways to Preview and Test your MiniApp:

  • In GoPay
    No limitation, you need to publish and release miniapp first. This will not appear in GoPay page until it's officially release so you may safely test this.
  • In Visual Studio Code
    Limitation: does not support certain SDKs (e.g., motion).
  • In Android Simulator
    Limitation: does not support GoPay JSAPIs (getAuthCode, launchDeeplink, launchUri, and launchPayment)
  • In IOS Simulator
    Limitation: does not support GoPay JSAPIs (getAuthCode, launchDeeplink, launchUri, and launchPayment)

Note: If you see errors while testing in a browser, it’s because the APIs are only supported within the GoPay app and are not available in browsers.


Test in GoPay

  1. Login to GoPay MiniApp Portal, Click your MiniApp, Open the Versions tab, and click "Release"

  2. In the Release tab, Click the QR Code for testing button, a QR code will appear.


  3. Scan the QR code and note the redirect URL. (QR will not work)

  4. Use the noted values to generate the deeplink using the template below:
    gopay://mini-app/windvane?app_id=<appId>&publish_id=<publishId>

Common mistakes:

  • Scanning the QR code only opens a page with extra information.
  • Ignore that page: instead, copy the URL link directly.
  • The useful values are in the URL. Copy appid and publishid to construct the deeplink.

Deeplink ParamsMandatoryDescriptionWhere this is being used
app_idMThis is your miniappid, you may get this from the portalTo open your latest miniapp version
publish_idOThis is your unreleased version id, you can get this when you try to publish the miniapp and get from the QR code note.To open your unreleased version of your miniapp (you need to include both app_id and publish_id)
mini_app_pathOThis is to specify your subpath of your miniapp where you want the user to land on, you can get this when.To redirect to a specific page inside your miniapp (the value of path has to be URL encoded)

Visual Studio Code

  1. Open VS Code and Render application.

  2. Click Preview Miniapp in the plugin sidebar.

    • Yes: Manually input your MiniApp preview URL.
    • No: The plugin will run your start script and show the preview input afterward.
  3. Paste your MiniApp URL in the top input field..

  4. The preview will appear inside VS Code..

  5. To debug, run Developer: Toggle Developer Tools from the command palette..

Android Simulator

  1. Click Preview Miniapp in Android Emulator..

  2. Enter the preview URL in the field that appears..

  3. Open Chrome → go tochrome://inspect/#devices → find the WebView and click Inspect..


IOS Simulator

  1. In Safari: Enable Develop menu in Preferences > Advanced.

  2. Click Preview Miniapp in iOS Emulator, then select a simulator.


  3. Enter the MiniApp preview URL.

  4. In Safari: Go to Develop > Simulator, then click the WebView to inspect it.

  5. Click the WebView object that you want to inspect, and then debug the miniapp in Web Inspector.