# 1. App Creation

# Introduction

Welcome to Integrator Studio (I.S.), a centralized platform in version 1 of our API documentation designed to streamline the app integration process for a seamless merchant experience.

With the new "App" concept, merchants no longer need to manage API keys or complex configurations. Instead, they can easily browse the app marketplace, select an app, and complete installation with pre-configured settings — all without technical obstacles.

The Integrator Studio (I.S.) dashboard empowers you to manage, test, and deploy your apps in a structured, secure, and efficient manner. From app creation to monitoring and deployment, I.S. offers all the tools needed to handle every stage of the app lifecycle within Armada Delivery Solution.

The Integrator Studio also eliminates the need for sandbox, staging, and production environments. Everything happens in production, with testing occurring through developer accounts — special merchant accounts with limited permissions. This setup allows you to install and test your apps before going live, without needing to switch between environments, ensuring a smoother workflow.

To access Integrator Studio, you’ll need to create an account or sign in using your credentials. Simply Sign Up to get started.

# Dashboard Overview and App List

This is how it will look if you have existing apps in your dashboard. From here, you can create or manage your apps with various actions:

# Create App

When creating a new app in Integrator Studio, you’ll need to fill in several essential fields. Here’s a quick overview of the fields to complete:

App Name: Provide a unique and descriptive name for your app.
App Icon: Upload an icon that will represent your app in the marketplace.
App Install URL: URL where the merchant will be redirected to your platform for installation and verification (details on the next page).
Callback URL: URL 2nd part of the installation & verification process (details on the next page).
Uninstall URL: URL for a webhook that notifies you when a user uninstalls the app from our platform.
Webhook URL: URL where delivery data (or other relevant events) will be sent from Armada Delivery to your platform.

Here’s an example of the app creation screen:

# Development Cycle

The development and release of an app within Integrator Studio (I.S.) follow a structured cycle, progressing through multiple phases to ensure quality and compliance. Each phase defines the app’s availability, editability, and visibility in the marketplace.

graph LR
    A[Prototype] --> B[Development]
    B --> C[In Review]
    C --> D[Production]
    D --> E[Deactivated]
    D --> F[Suspended]
    F --> D
    E --> D

Prototype
The app is in an unpublished state and can be freely edited. This phase allows developers to design and configure their app before making it available for testing.
Development
The app is published in a development environment, where it remains editable and can be tested with developer accounts. This phase allows for functional testing and refinement before moving to production.
In Review
Once development is complete, the app enters the review phase. At this stage, the app is locked for editing and undergoes a thorough review to ensure it meets all platform requirements for production.
Production
The app is fully published and available for use in the marketplace. Merchants can access and install the app, enabling real-world usage.
Deactivated
The app remains in production but has been temporarily deactivated. Users cannot access or install it until it is reactivated, which can be done by the app owner or administrator.
Suspended
If an app is found in violation of platform policies or terms, it may be marked as Suspended by Armada. During this phase, the app is temporarily taken down and remains inaccessible to users until the issues are resolved. Once compliant, the app can return to Production.

# Summary