{"id":1342,"date":"2024-12-11T03:05:27","date_gmt":"2024-12-11T03:05:27","guid":{"rendered":"https:\/\/support-landing.altegio.cloud\/support\/6746128692893-working-with-subscription-payments-in-the-marketplace\/"},"modified":"2025-07-21T15:12:04","modified_gmt":"2025-07-21T15:12:04","password":"","slug":"6746128692893-working-with-subscription-payments-in-the-marketplace","status":"publish","type":"docs","link":"https:\/\/alteg.io\/en\/support\/knowledge-base\/6746128692893-working-with-subscription-payments-in-the-marketplace\/","title":{"rendered":"Working with subscription payments in the marketplace"},"content":{"rendered":"<h2>Transferring information about paying for a subscription to your service<\/h2>\n<p><span style=\"font-weight: 400;\">When the integration is activated, your application will be connected to a branch with a trial subscription. You specify the duration of the trial subscription in your account in the <strong>\u201cMonetization\u201d<\/strong> section.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">When paying for a subscription to your service, you will need to send payment information to Altegio via API for a description of the request to pay for a <\/span><span style=\"font-weight: 400;\">subscription <\/span><strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Marketplace\/operation\/marketplace.notifications.callback_with_payment\" target=\"_blank\" rel=\"noopener\">API Documentation<\/a><\/strong><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">If by the end of the trial you do not provide Altegio with information about the payment for the subscription, then the integration will be automatically disabled within 24 hours.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">Subscription payment details must be sent each time you pay for a subscription.<\/span><\/p>\n<h2>Auto-deactivate integration<\/h2>\n<p><span style=\"font-weight: 400;\">Auto-disable integration means that:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">You will no longer be able to access the API of the disabled branch.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">Will stop sending events to the webhook addresses you specified.<\/span><\/li>\n<\/ul>\n<p><span style=\"font-weight: 400;\">Integration is automatically disabled in two cases:<\/span><\/p>\n<ul>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">If before the end of the trial subscription you do not send Altegio the information that the user has paid for a subscription to your service.<\/span><\/li>\n<li style=\"font-weight: 400;\" aria-level=\"1\"><span style=\"font-weight: 400;\">If by the end date of the previously paid subscription, information about the payment for the subscription for the next period is not transmitted.<\/span><\/li>\n<\/ul>\n<h2>Renewing a subscription<\/h2>\n<p><span style=\"font-weight: 400;\">If the integration was disabled automatically, then upon receiving a request to pay for a subscription, it will be activated back \u2014 the system user will reappear in the branch, and your webhook addresses will be added to the branch again.<\/span><\/p>\n<h2>Paid Subscription Cancellation and Refund<\/h2>\n<p><span style=\"font-weight: 400;\">To make a refund and disable integration for a branch office, you can <\/span><span style=\"font-weight: 400;\">submit a request to <\/span><strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Marketplace\/operation\/marketplace.partner.callback_with_payment.refund\" target=\"_blank\" rel=\"noopener\">the Refunds API<\/a><\/strong><span style=\"font-weight: 400;\">.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">If you make a refund on an active branch subscription, then the integration on the Altegio side will be disabled within an hour \u2014 the system user will be removed from the branch and sending webhooks will be disabled.<\/span><\/p>\n<p><span style=\"font-weight: 400;\">To return by transaction, you need to pass the ID of the transaction for which you want to issue a return.<\/span><span style=\"font-weight: 400;\"> You receive the transaction ID in <\/span><strong><a href=\"https:\/\/developer.alteg.io\/api#tag\/Marketplace\/operation\/marketplace.partner.callback_with_payment.refund\" target=\"_blank\" rel=\"noopener\">the API response when sending information about paying for a subscription to your service<\/a><\/strong><a href=\"https:\/\/developers.yclients.com\/ru\/#tag\/Vitrina-uvedomlenij\/operation\/marketplace.partner.callback_with_payment.refund\"><span style=\"font-weight: 400;\">.<\/span><\/a><\/p>\n<h2>Changing the cost\/duration of an already paid subscription<\/h2>\n<p><font>If you need to change the cost or duration of a paid subscription, then you need to:<\/font><\/p>\n<ul>\n<li><font>Cancel an existing payment.<\/font><\/li>\n<li><font>Send via API new information about the payment and the duration of the subscription (or several subscriptions: one with the old price, valid until the subscription price increase, and the second with the new price, valid from the moment the price increases).<\/font><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Transferring information about paying for a subscription to your service When the integration is activated, your application will be connected to a branch with a trial subscription. You specify the duration of the trial subscription in your account in the \u201cMonetization\u201d section. When paying for a subscription to your service, you will need to send&hellip; <a class=\"more-link\" href=\"https:\/\/alteg.io\/en\/support\/knowledge-base\/6746128692893-working-with-subscription-payments-in-the-marketplace\/\">Continue reading <span class=\"screen-reader-text\">Working with subscription payments in the marketplace<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[109],"doc_tag":[2086,1894,2071],"class_list":["post-1342","docs","type-docs","status-publish","hentry","doc_category-placement-in-the-altegio-marketplace","doc_tag-billing-en","doc_tag-financial-transactions-en","doc_tag-integrations-en","entry"],"aioseo_notices":[],"year_month":"2026-04","word_count":422,"total_views":"660","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"ivan.k","author_nicename":"altegio","author_url":"https:\/\/alteg.io\/en\/author\/altegio\/"},"doc_category_info":[{"term_name":"Placement in the Altegio Marketplace","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/categories\/placement-in-the-altegio-marketplace\/"}],"doc_tag_info":[{"term_name":"Billing","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/docs-tag\/billing-en\/"},{"term_name":"Financial Transactions","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/docs-tag\/financial-transactions-en\/"},{"term_name":"Integrations","term_url":"https:\/\/alteg.io\/en\/support\/knowledge-base\/docs-tag\/integrations-en\/"}],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/1342","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/comments?post=1342"}],"version-history":[{"count":1,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/1342\/revisions"}],"predecessor-version":[{"id":169465,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/docs\/1342\/revisions\/169465"}],"wp:attachment":[{"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/media?parent=1342"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_category?post=1342"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/alteg.io\/en\/support\/wp-json\/wp\/v2\/doc_tag?post=1342"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}