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.
Submit an app
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.
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.
Manage a submitted app
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 .
Consume API endpoints a user
- 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.
Create webhooks for users
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.
Deactivate a user's application instance
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.
Install an app
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 .
Uninstall an app
- In the left navigation bar, click App Store , then click an installed app.
- In the bottom left corner, click Uninstall .