This topic describes how to submit an application to the Rebilly App Store, and how to manage your applications.
The App Store enables integration with Rebilly services. It enables merchants to create their own apps, and use them to access and update user data.
This topic describes how to submit an application to the Rebilly App Store.
In Rebilly, apps contain the following:
- A set of informative fields: name, tagline, logo, authorLogo, authorName, and description.
- A set of permissions that merchants can use on behalf of their users.
- A set of properties that define which settings the user must configure when they install your app. Rebilly automatically renders UI fields for these properties. To build your own UI settings, see Build UI settings form .
To submit an app:
- Execute the PostApplication operation, and provide all required fields.
- Notify Rebilly that you have submitted an app.
- Wait for your app to be approved. When your app is approved, it is made available in the App Store, where users can install and use your app.
If your app is not approved, Rebilly will contact you and inform you of adjustments that may need to be made.
A "Hello World" app is available in the Rebilly sandbox as an example.
The code is publicly available in this GitHub repository.
This section describes how to manage your Rebilly application.
To identify users that have installed your app, select one of the following:
- Fetch the whole list using the GetApplicationInstanceCollection endpoint,
- Create webhooks for the installed and uninstalled events,
- Create binds with webhooks for the same events. For more information on rules and binds, see Automation .
- Fetch an instance using the Retrieve application instance operation. The Rebilly API creates an application JWT and sends it with the payload.
- Use the application JWT to authenticate as the user. The application JWT is valid for 1 hour.
PostServiceCredentialpermissions to your app.
- Create a webhook service credential .
- Use the PostWebhook operation to create webhooks that trigger on your users' account and to notify your application that an event occurred.
To deactivate a user's application on their behalf, execute the Delete application instance operation.
By default, this endpoint permission is included in your application.
To build your own UI settings form, implement it on your website and provide the configurationUrl property
when submitting an app. The user is redirected to this URL when they install an app. The URL contains a
jwt query parameter
along with data that identifies the user such as organization, application, issuer website (live or sandbox), and key ID.
Disclaimer: Rebilly does not verify app code, quality, or accept any liability for third-party apps. Ensure that you know and trust the app vendor before installing.
- In the left navigation bar, click App Store , then click an app.
- Read the app information.
- Click Settings and complete the required fields.
- Click Install .
- Assess the permissions that the app will gain. If you are happy with the permissions, click Authorize .
- In the left navigation bar, click App Store , then click an installed app.
- In the bottom left corner, click Uninstall .