Sending subscription payment information to Altegio #
When the integration is activated, your app will be connected to the location with a trial subscription. You specify the trial duration in the developer account under Monetization.
When a user pays for a subscription to your service, you must send the payment information to Altegio via API. See the API documentation for the request description for subscription payment.
If you do not send Altegio the subscription payment information before the trial ends, the integration will be automatically disabled within 24 hours.
You must send subscription payment data every time the subscription is paid.
Automatic integration disabling #
Automatic integration disabling means that:
- you will no longer be able to access the API of the disabled location;
- events will stop being sent to the webhook URLs you specified.
Automatic integration disabling happens in two cases:
- If you do not send Altegio information that the user paid for the subscription to your service before the trial subscription ends.
- If, by the end date of a previously paid subscription, you do not send payment information for the next subscription period.
Subscription renewal #
If the integration was disabled automatically, then when Altegio receives the subscription payment request, the integration will be activated again — the system user will appear in the location again, and your webhook URLs will be added to the location again.
Canceling a paid subscription and refunds #
To issue a refund and disable the integration for a location, you can send a request to the refunds API.
If you issue a refund for an active location subscription, the integration on the Altegio side will be disabled within 1 hour — the system user will be removed from the location and webhook sending will be stopped.
To refund a transaction, you need to pass the transaction ID you want to refund. You receive the transaction ID in the API response when you send Altegio the subscription payment information for your service.
Changing the price/duration of an already paid subscription #
If you need to change the price or duration of a paid subscription, you need to:
- Cancel the existing payment.
- Send new payment information and the new subscription duration via API (or multiple subscriptions: one with the old price valid until the price increase moment, and the second with the new price valid starting from the price increase moment).
