Dokumentacja dla programistów
Utwórz rabat
Marketplace aplikacjiAplikacje monday.com
Możesz tworzyć rabaty dla potencjalnych i obecnych klientów za pomocą Centrum dewelopera (Developer Center) lub API. Po utworzeniu rabatu:
- Potencjalni klienci zobaczą obniżoną cenę podczas finalizowania zakupu, gdy wybiorą plan objęty rabatem.
- Obecni klienci otrzymają rabat automatycznie w kolejnym cyklu rozliczeniowym lub po przejściu na plan objęty rabatem.
Centrum dewelopera
- Otwórz aplikację w Centrum dewelopera.
- W menu po lewej stronie kliknij Monetyzacja (Monetization).
- Na stronie Monetyzacja wybierz kartę Rabaty (Discounts), aby wyświetlić rabaty.
- W prawym górnym rogu kliknij Przyznaj nowy rabat (Grant a new discount).
- Wpisz slug konta (Account slug). Znajdziesz go w webhookach lub możesz go uzyskać, wykonując zapytanie o konto przez API.
Na tym etapie system sprawdzi, czy konto ma aktywną subskrypcję Twojej aplikacji:
- Jeśli nie ma aktywnej subskrypcji, zobaczysz odpowiedni komunikat.
- Jeśli konto ma aktywną subskrypcję, jej szczegóły pojawią się w sekcji Aktywny plan (Active plan). Zobaczysz nazwę planu, status subskrypcji, częstotliwość rozliczeń i datę kolejnego cyklu rozliczeniowego.
- Wybierz plan, do którego chcesz zastosować rabat, lub wybierz Wszystkie plany (All plans). * Jeśli konto ma aktywną subskrypcję, możesz zastosować rabat do obecnego planu lub innego planu. Nie musisz stosować rabatu do aktualnego planu.
- Określ, czy rabat dotyczy subskrypcji miesięcznej, czy rocznej. Jeśli nie wiesz, którą opcję wybierze klient, zaznacz obie.
- Wpisz wysokość rabatu w procentach.
- Wpisz, przez ile dni rabat będzie obowiązywać. W tym czasie potencjalni klienci mogą skorzystać z rabatu, a obecni klienci otrzymają obniżoną cenę. Po upływie tego okresu potencjalni klienci nie będą już mogli skorzystać z rabatu, a rabat zostanie usunięty z subskrypcji obecnych klientów.
- Kliknij Przyznaj rabat (Grant discount).
API
Aby utworzyć rabat przez API, użyj mutacji create_marketplace_app_discount.
mutation {
create_marketplace_app_discount(
app_id: "12345"
account_slug: "my-company"
discount_data: {
discount: 20
days_valid: 30
period: MONTHLY
app_plan_ids: ["plan_001"]
}
) {
granted_discount {
app_id
app_plan_ids
discount
period
}
}
}
Rozwiązywanie problemów
Jeśli podczas próby przyznania rabatu pojawi się błąd, sprawdź w tabeli poniżej, co może być jego przyczyną:
| Komunikat o błędzie | Przyczyna |
|---|---|
| Failed to grant discount - Check your inputs | Użytkownik podał nieprawidłowe dane, np. ujemną wartość rabatu w procentach |
| Failed to grant discount - Invalid account details | Konto o podanym identyfikatorze nie istnieje |
| Failed to grant discount - App isn't installed on the account | Aplikacja nie jest zainstalowana na koncie |
| Failed to grant discount - User cannot grant discounts | Osoba przyznająca rabat nie jest współpracownikiem aplikacji i nie może przyznawać rabatów |