{"id":137902,"date":"2022-12-15T00:00:00","date_gmt":"2022-12-15T00:00:00","guid":{"rendered":"https:\/\/adapty.io\/pl-android-in-app-purchases-part-5-server-side-purchase-validation\/"},"modified":"2022-12-15T00:00:00","modified_gmt":"2022-12-15T00:00:00","slug":"android-in-app-purchases-part-5-server-side-purchase-validation","status":"publish","type":"post","link":"https:\/\/adapty.io\/pl\/blog\/android-in-app-purchases-part-5-server-side-purchase-validation\/","title":{"rendered":"Zakupy w aplikacji na Androida, cz\u0119\u015b\u0107 5: walidacja zakup\u00f3w po stronie serwera"},"content":{"rendered":"\n<p>Walidacja po stronie serwera (server-side validation) mo\u017ce pom\u00f3c w weryfikacji autentyczno\u015bci zakupu. Urz\u0105dzenie wy\u015ble \u017c\u0105danie do serwer\u00f3w Google, aby dowiedzie\u0107 si\u0119, czy zakup rzeczywi\u015bcie mia\u0142 miejsce i czy jest poprawny.<\/p>\n\n\n\n<p>W tym przewodniku om\u00f3wimy, jak skonfigurowa\u0107 walidacj\u0119 po stronie serwera dla aplikacji na Androida.&nbsp;<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"dlaczego-warto-dokonywac-walidacji-zakupow\">Dlaczego warto dokonywa\u0107 walidacji zakup\u00f3w<\/h2>\n\n\n\n<p>Nale\u017cy zauwa\u017cy\u0107, \u017ce walidacja po stronie serwera nie jest obowi\u0105zkowa i zakupy w aplikacji b\u0119d\u0105 dzia\u0142a\u0107 tak\u017ce bez niej. Istniej\u0105 jednak pewne znacz\u0105ce jej korzy\u015bci:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Zaawansowana analityka p\u0142atno\u015bci, <\/strong>kt\u00f3ra jest szczeg\u00f3lnie wa\u017cna w przypadku subskrypcji, poniewa\u017c wszystko, co dzieje si\u0119 po aktywacji, nie jest przetwarzane przez urz\u0105dzenie. Bez przetwarzania zakupu po stronie serwera nie b\u0119dzie mo\u017cna odzyska\u0107 bie\u017c\u0105cego statusu subskrypcji i dowiedzie\u0107 si\u0119, czy u\u017cytkownik odnowi\u0142 lub anulowa\u0142 subskrypcj\u0119, czy wyst\u0119puj\u0105 problemy z p\u0142atno\u015bci\u0105, i tak dalej.<\/li>\n\n\n\n<li><strong>Mo\u017cliwo\u015b\u0107 weryfikacji autentyczno\u015bci zakupu. <\/strong>B\u0119dziesz mie\u0107 pewno\u015b\u0107, \u017ce transakcja nie jest oszustwem, a u\u017cytkownik faktycznie zap\u0142aci\u0142 za tw\u00f3j produkt.<\/li>\n\n\n\n<li><strong>Subskrypcje mi\u0119dzy platformami. <\/strong>Je\u015bli mo\u017cesz sprawdzi\u0107 status subskrypcji u\u017cytkownika w czasie rzeczywistym, mo\u017cesz zsynchronizowa\u0107 j\u0105 z innymi platformami. Na przyk\u0142ad u\u017cytkownik, kt\u00f3ry kupi\u0142 subskrypcj\u0119 z urz\u0105dzenia z systemem iOS, b\u0119dzie m\u00f3g\u0142 z niej korzysta\u0107 na Androidzie, na stronie internetowej i na innych platformach.&nbsp;<\/li>\n\n\n\n<li><strong>Mo\u017cliwo\u015b\u0107 kontrolowania dost\u0119pu do tre\u015bci od strony serwera<\/strong>, kt\u00f3ry chroni przed u\u017cytkownikami pr\u00f3buj\u0105cymi uzyska\u0107 dost\u0119p do danych bez subskrypcji, po prostu wykonuj\u0105c \u017c\u0105dania do serwera.&nbsp;<\/li>\n<\/ol>\n\n\n\n<p>M\u00f3wi\u0105c z naszego do\u015bwiadczenia, pierwsza zaleta wystarczy, aby skonfigurowa\u0107 przetwarzanie zakup\u00f3w po stronie serwera.<\/p>\n\n\n\n\n\n<h2 class=\"wp-block-heading\" id=\"walidacja-platnosci\">Walidacja p\u0142atno\u015bci<\/h2>\n\n\n\n<p>Mo\u017cemy podsumowa\u0107 walidacj\u0119 p\u0142atno\u015bci Androida za pomoc\u0105 tego schematu:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" src=\"https:\/\/adapty.io\/wp-content\/uploads\/2023\/01\/616ecfda9345ee7e2b53d608_vkx4uyzcwdhqdwubf7srxr8us7k37emw9fybjgkduzdvuq6whxgsne4zn9bqt2g052sg2va6lgr0zi5wue22vnkls6wsql1mdozqnmrcrlk-rb86shh7dag2fzdho-gpavemctll3ds1600.png\" alt=\"\"><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"uwierzytelnianie-dla-zadan-google-play-developer-api\">Uwierzytelnianie dla \u017c\u0105da\u0144 Google Play Developer API<\/h3>\n\n\n\n<p>Aby pracowa\u0107 z Google Play Developer API, musisz najpierw wygenerowa\u0107 klucz do podpisania \u017c\u0105da\u0144. Najpierw musisz po\u0142\u0105czy\u0107 swoje konto konsoli Google Play (gdzie zarz\u0105dzasz aplikacj\u0105) z kontem Google Cloud (gdzie wygenerujesz klucz do podpisywania \u017c\u0105da\u0144). Po skonfigurowaniu wszystkiego konieczne b\u0119dzie przyznanie u\u017cytkownikowi prawa do zarz\u0105dzania zakupami. Potrzebny by\u0142by dedykowany artyku\u0142, aby opisa\u0107 ten proces. Na szcz\u0119\u015bcie om\u00f3wili\u015bmy to ju\u017c w przewodniku &#8222;krok po kroku&#8221;, kt\u00f3ry znajduje si\u0119 w <a href=\"https:\/\/docs.adapty.io\/docs\/service-account-key-file\" target=\"_blank\" rel=\"noopener\">dokumentacji Adapty<\/a>.&nbsp;<\/p>\n\n\n\n<p>Zauwa\u017c, \u017ce zwykle musisz poczeka\u0107 24 godziny lub wi\u0119cej po wygenerowaniu klucza, aby zacz\u0105\u0142 dzia\u0142a\u0107. Aby tego unikn\u0105\u0107, po prostu zaktualizuj opis dowolnego produktu w aplikacji lub subskrypcji, kt\u00f3ra natychmiast aktywuje klucz.&nbsp;<\/p>\n\n\n\n<p>Korzystamy z oficjalnej biblioteki <a href=\"https:\/\/github.com\/googleapis\/google-api-python-client\" target=\"_blank\" rel=\"noopener nofollow\">google-api-python-client<\/a> do wsp\u00f3\u0142pracy z Google Play Developer API. Ta biblioteka jest dost\u0119pna dla wi\u0119kszo\u015bci popularnych j\u0119zyk\u00f3w i polecam jej u\u017cywanie, poniewa\u017c obs\u0142uguje wszystkie metody, jakich tylko mo\u017cesz potrzebowa\u0107.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"walidacja-transakcji-subskrypcyjnych\">Walidacja transakcji subskrypcyjnych<\/h3>\n\n\n\n<p>W przeciwie\u0144stwie do <a href=\"https:\/\/adapty.io\/blog\/ios-in-app-purchases-part-4-server-side-purchase-validation\" target=\"_blank\" rel=\"noopener\">walidacji po stronie serwera iOS<\/a>, w Androidzie zar\u00f3wno subskrypcja, jak i inne walidacje produktu s\u0105 realizowane przy u\u017cyciu r\u00f3\u017cnych metod. Dlatego podczas zatwierdzania transakcji musisz wiedzie\u0107, czy masz do czynienia z produktem, czy subskrypcj\u0105. W praktyce oznacza to, \u017ce musisz przes\u0142a\u0107 te dane z aplikacji mobilnej, a tak\u017ce zachowa\u0107 oznaczenie w bazie danych na wypadek, gdyby konieczna by\u0142a ponowna walidacja tokenu.<\/p>\n\n\n\n<p>Drug\u0105 wa\u017cn\u0105 r\u00f3\u017cnic\u0105 jest to, \u017ce podczas gdy ka\u017cda transakcja ma sw\u00f3j w\u0142asny token w systemie Android, wszystkie transakcje na iOS u\u017cywaj\u0105 wsp\u00f3\u0142dzielonego sekretu, specyficznego dla aplikacji do przechowywania ca\u0142ej historii transakcji. Oznacza to, \u017ce je\u015bli chcesz by\u0107 w stanie przywr\u00f3ci\u0107 zakupy u\u017cytkownika w dowolnym momencie, konieczne jest przechowywanie wszystkich token zakupu, w przeciwie\u0144stwie do arbitralnego wybierania jednego z nich.<\/p>\n\n\n\n<p>Aby zweryfikowa\u0107 subskrypcj\u0119, musisz wywo\u0142a\u0107 metod\u0119 <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions\/get\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.subscriptions.get<\/em><\/a>.&nbsp; Zasadniczo jest to wywo\u0142anie \u017c\u0105dania GET:<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"https:\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/subscriptions\/{subscriptionId}\/tokens\/{token}\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #D8DEE9FF\">https<\/span><span style=\"color: #81A1C1\">:<\/span><span style=\"color: #616E88\">\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/subscriptions\/{subscriptionId}\/tokens\/{token}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Wszystkie parametry s\u0105 wymagane:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>packageName<\/em>: identyfikator aplikacji, np. com.adapty.sample_app.<\/li>\n\n\n\n<li><em>subscriptionId<\/em>: identyfikator subskrypcji dla subskrypcji, kt\u00f3ra powinna zosta\u0107 walidowana, np. com.adapty.sample_app.weekly_sub.<\/li>\n\n\n\n<li><em>token<\/em>: unikalny token transakcji. Pojawia si\u0119 po przetworzeniu zakupu po stronie aplikacji mobilnej.<\/li>\n<\/ul>\n\n\n\n<p>Najpierw przyjrzyjmy si\u0119 komunikatom o b\u0142\u0119dach, kt\u00f3re nale\u017cy usun\u0105\u0107, aby upewni\u0107 si\u0119, \u017ce wszystko dzia\u0142a tak, jak powinno:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>400, Invalid grant: account not found<\/strong>: ten komunikat o b\u0142\u0119dzie oznacza, \u017ce klucz uwierzytelniania \u017c\u0105dania zosta\u0142 wygenerowany nieprawid\u0142owo. Upewnij si\u0119, \u017ce Twoje konta s\u0105 po\u0142\u0105czone, u\u017cywasz w\u0142a\u015bciwego, kt\u00f3ry ma wystarczaj\u0105ce uprawnienia oraz \u017ce wszystkie wymagane interfejsy API s\u0105 aktywowane. Zobacz sekcj\u0119 poni\u017cej, aby dowiedzie\u0107 si\u0119, jak wszystko skonfigurowa\u0107. Zwr\u00f3\u0107 uwag\u0119 na wskaz\u00f3wk\u0119 dotycz\u0105c\u0105 aktualizacji opisu produktu.<\/li>\n\n\n\n<li><strong>400, The purchase token does not match the package name<\/strong>: ten komunikat o b\u0142\u0119dzie jest zwykle spotykany w przypadku nieuczciwych transakcji. Je\u015bli zobaczysz go podczas testowania, upewnij si\u0119, \u017ce nie u\u017cywasz tokena zakupu aplikacji nale\u017c\u0105cego do innej aplikacji.<\/li>\n\n\n\n<li><strong>403, Quota exceeded for quota metric 'Queries&#8217; and limit 'Queries per day&#8217; of service 'androidpublisher.googleapis.com&#8217;<\/strong>: oznacza to, \u017ce dzienny limit \u017c\u0105da\u0144 API Google zosta\u0142 przekroczony. Domy\u015blnie mo\u017cna wykona\u0107 <a href=\"https:\/\/developers.google.com\/android-publisher\/quotas\" target=\"_blank\" rel=\"noopener nofollow\">do 200 000<\/a> \u017c\u0105da\u0144 na dzie\u0144. Ten limit mo\u017ce zosta\u0107 zwi\u0119kszony, ale powinien wystarczy\u0107 dla wi\u0119kszo\u015bci aplikacji. Je\u015bli napotkasz ten limit, prawdopodobnie powiniene\u015b dok\u0142adnie sprawdzi\u0107 logik\u0119 aplikacji i upewni\u0107 si\u0119, \u017ce wszystko jest w porz\u0105dku.<\/li>\n\n\n\n<li><strong>410, The subscription purchase is no longer available for query because it has been expired for too long<\/strong>: ten komunikat o b\u0142\u0119dzie pojawia si\u0119 w transakcjach, w kt\u00f3rych subskrypcja wygas\u0142a ponad 60 dni temu. Nie jest to rzeczywisty komunikat o b\u0142\u0119dzie i nie powinien by\u0107 przetwarzany jako taki.<\/li>\n<\/ul>\n\n\n\n\n\n<h3 class=\"wp-block-heading\" id=\"transakcja-subskrypcji\">Transakcja subskrypcji&nbsp;<\/h3>\n\n\n\n<p>Je\u015bli walidacja przebieg\u0142a pomy\u015blnie, otrzymasz <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions#SubscriptionPurchase\" target=\"_blank\" rel=\"noopener nofollow\">dane transakcji<\/a> jako odpowied\u017a.<\/p>\n\n\n\n<p>Dane transakcji (dla subskrypcji):<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"{\n    &quot;expiryTimeMillis&quot;: &quot;1631116261362&quot;,\n    &quot;paymentState&quot;: 1,\n    &quot;acknowledgementState&quot;: 1,\n    &quot;kind&quot;: &quot;androidpublisher#subscriptionPurchase&quot;,\n    &quot;orderId&quot;: &quot;GPA.3382-9215-9042-70164&quot;,\n    &quot;startTimeMillis&quot;: &quot;1630504367892&quot;,\n    &quot;autoRenewing&quot;: true,\n    &quot;priceCurrencyCode&quot;: &quot;USD&quot;,\n    &quot;priceAmountMicros&quot;: &quot;1990000&quot;,\n    &quot;countryCode&quot;: &quot;US&quot;,\n    &quot;developerPayload&quot;: &quot;&quot;\n}\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">expiryTimeMillis<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">1631116261362<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">paymentState<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #B48EAD\">1<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">acknowledgementState<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #B48EAD\">1<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">kind<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">androidpublisher#subscriptionPurchase<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">orderId<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">GPA.3382-9215-9042-70164<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">startTimeMillis<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">1630504367892<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">autoRenewing<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #81A1C1\">true<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">priceCurrencyCode<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">USD<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">priceAmountMicros<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">1990000<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">countryCode<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">US<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">developerPayload<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;&quot;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Aby dowiedzie\u0107 si\u0119, czy u\u017cytkownik ma dost\u0119p do opcji premium oferowanych przez aplikacj\u0119 (tj. czy posiada aktywn\u0105 subskrypcj\u0119), konieczne jest:<\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Sprawd\u017a parametry <em>startTimeMillis<\/em> oraz <em>expiryTimeMillis<\/em>. Aktualny czas powinien by\u0107 mi\u0119dzy nimi.<\/li>\n\n\n\n<li>Co wi\u0119cej, musisz upewni\u0107 si\u0119, \u017ce parametr <em>paymentState<\/em> nie posiada warto\u015bci '0&#8242;. Oznacza\u0142oby to, \u017ce zakup subskrypcji jest nadal w toku, dlatego nie ma jeszcze potrzeby przyznawania u\u017cytkownikowi dost\u0119pu do funkcji premium.&nbsp;<\/li>\n\n\n\n<li>Je\u015bli transakcja posiada warto\u015b\u0107 <em>autoResumeTimeMillis <\/em>, w takim wypadku abonament zostaje wstrzymany. Oznacza to, \u017ce u\u017cytkownik nie powinien otrzyma\u0107 dost\u0119pu do funkcji premium przed okre\u015blon\u0105 dat\u0105.<\/li>\n<\/ol>\n\n\n\n<p>Zobaczmy kluczowe warto\u015bci transakcji subskrypcji:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>kind:<\/em> rodzaj transakcji. W przypadku subskrypcji zawsze posiada warto\u015b\u0107 <em>androidpublisher#subscriptionPurchase<\/em>. Dzi\u0119ki temu parametrowi mo\u017cesz zrozumie\u0107, czy masz do czynienia z subskrypcj\u0105, czy produktem, i odpowiednio wybra\u0107 logik\u0119 przetwarzania.<\/li>\n\n\n\n<li><em>paymentState:<\/em> status p\u0142atno\u015bci. Ta warto\u015b\u0107 nie jest obecna dla wygas\u0142ych transakcji. Mo\u017cliwe warto\u015bci to:<br><strong><em>0<\/em>:<\/strong> Ten zakup nie zosta\u0142 jeszcze przetworzony. W niekt\u00f3rych krajach u\u017cytkownik mo\u017ce zap\u0142aci\u0107 za subskrypcj\u0119 na oddzielnym urz\u0105dzeniu. Oznacza to, \u017ce u\u017cytkownik inicjuje zakup subskrypcji ze swojego urz\u0105dzenia, a p\u0142aci za ni\u0105 w pobliskim terminalu. Og\u00f3lnie rzecz bior\u0105c, jest to do\u015b\u0107 rzadki przypadek, ale nadal nale\u017cy o nim pami\u0119ta\u0107.<br><strong><em>1<\/em>:<\/strong> Zakupiono abonament.<br><strong><em>2<\/em>:<\/strong> Subskrypcja jest w okresie pr\u00f3bnym.<br><strong><em>3<\/em>:<\/strong> Subskrypcja zostanie podwy\u017cszona lub obni\u017cona w nast\u0119pnym okresie. Oznacza to, \u017ce plan subskrypcji b\u0119dzie ulega\u0142 zmianie.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>acknowledgementState<\/em>: status potwierdzenia zakupu. Jest to wa\u017cny parametr, kt\u00f3ry potwierdza, czy u\u017cytkownik otrzyma\u0142 dost\u0119p do tego, za co zap\u0142aci\u0142. Warto\u015b\u0107 &#8222;0&#8221; oznacza, \u017ce nie posiada dost\u0119pu, a &#8222;1&#8221; oznacza, \u017ce go ma. Deweloper jest odpowiedzialny za zdefiniowanie tego statusu, co mo\u017cna zrobi\u0107 zar\u00f3wno po stronie aplikacji mobilnej, jak i serwera. Je\u015bli nie potwierdzisz zakupu w ci\u0105gu 3 dni od jego dokonania, zostanie on automatycznie zwr\u00f3cony. Polecam wdro\u017cenie tej logiki: po otrzymaniu transakcji zawieraj\u0105cej <em>acknowledgementState=0<\/em>, parametr zostanie zmieniony przez serwer. Opowiem, jak to zrobi\u0107 poni\u017cej.&nbsp;<\/li>\n\n\n\n<li><em>orderId<\/em>: unikalny identyfikator transakcji. Ka\u017cdy zakup lub odnowienie subskrypcji (subscription renewal) b\u0119dzie posiada\u0142o sw\u00f3j w\u0142asny identyfikator, kt\u00f3ry mo\u017cna wykorzysta\u0107, aby dowiedzie\u0107 si\u0119, czy ta transakcja zosta\u0142a ju\u017c przetworzona wcze\u015bniej. Ka\u017cdy identyfikator odnowienia b\u0119dzie posiada\u0107 sta\u0142\u0105 pierwsz\u0105 po\u0142ow\u0119, do kt\u00f3rej do\u0142\u0105czane s\u0105 dwie kropki i liczba odnowie\u0144 subskrypcji (zaczynaj\u0105ca si\u0119 od 0). Je\u015bli subskrypcja podczas aktywacji posiada\u0142a identyfikator GPA.3382-9215-9042-70164, w\u00f3wczas pierwsze odnowienie zostanie zidentyfikowane jako GPA.3382-9215-9042-70164..0, drugie GPA.3382-9215-9042-70164..1, itd. W ten spos\u00f3b mo\u017cesz tworzy\u0107 \u0142a\u0144cuchy transakcji i \u015bledzi\u0107 liczb\u0119 odnowie\u0144.<\/li>\n\n\n\n<li><em>startTimeMillis<\/em>: data rozpocz\u0119cia subskrypcji.<\/li>\n\n\n\n<li><em>expiryTimeMillis<\/em>: data wyga\u015bni\u0119cia subskrypcji.<\/li>\n\n\n\n<li><em>autoRenewing<\/em>: znacznik wskazuj\u0105cy, czy subskrypcja ma zosta\u0107 przed\u0142u\u017cona na kolejny okres.<\/li>\n\n\n\n<li><em>priceCurrencyCode<\/em>: waluta zakupu w formacie trzyliterowym, np. USD.<\/li>\n\n\n\n<li><em>priceAmountMicros:<\/em> cena zakupu. Aby uzyska\u0107 normaln\u0105 warto\u015b\u0107 ceny, podziel t\u0119 warto\u015b\u0107 przez 1000000. Oznacza to, \u017ce 1990000 w rzeczywisto\u015bci oznacza 1,99.&nbsp;<\/li>\n\n\n\n<li><em>countryCode:<\/em> kraj zakupu w formacie dwuliterowym, np. US<\/li>\n\n\n\n<li><em>purchaseType:<\/em> rodzaj zakupu. Ten klucz nie b\u0119dzie obecny w wi\u0119kszo\u015bci przypadk\u00f3w. Jest nadal wa\u017cne, aby wzi\u0105\u0107 go pod uwag\u0119, poniewa\u017c pomaga on zrozumie\u0107, czy zakup zosta\u0142 dokonany w \u015brodowisku Sandbox. Mo\u017cliwe warto\u015bci to:<br><strong><em>0: <\/em><\/strong><em>zakup zosta\u0142 dokonany w \u015brodowisku Sandbox, dlatego nie powinien by\u0107 uwzgl\u0119dniany w danych analitycznych.<br><\/em><strong><em>1: <\/em><\/strong><em>zakup zosta\u0142 dokonany przy u\u017cyciu kodu promocyjnego.&nbsp;<\/em><\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>autoResumeTimeMillis<\/em>: data odnowienia subskrypcji. Jest on obecny tylko dla subskrypcji, kt\u00f3re zosta\u0142y wcze\u015bniej wstrzymane. Je\u015bli ten parametr jest obecny, nie musisz przyznawa\u0107 u\u017cytkownikowi dost\u0119pu do funkcji premium przed podan\u0105 dat\u0105.<\/li>\n\n\n\n<li><em>cancelReason<\/em>: Pow\u00f3d, dla kt\u00f3rego subskrypcja nie zostanie odnowiona. Mo\u017cliwe warto\u015bci to:<br><strong><em>0:<\/em><\/strong><em> u\u017cytkownik anulowa\u0142 automatyczne odnawianie subskrypcji.<br><\/em><strong><em>1: <\/em><\/strong><em>subskrypcja zosta\u0142a anulowana przez system. Jest to najcz\u0119\u015bciej spowodowane przez problemy z rozliczeniami. <br><\/em><strong><em>2<\/em>: <\/strong>u\u017cytkownik przeszed\u0142 na inny plan subskrypcji. <br><strong><em>3<\/em>:<\/strong> deweloper anulowa\u0142 subskrypcj\u0119.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>userCancellationTimeMillis<\/em>: dane dotycz\u0105ce anulowania odnowienia subskrypcji. Wyst\u0119puje tylko wtedy, gdy cancelReason wynosi 0. Subskrypcja mo\u017ce by\u0107 nadal aktywna-aby si\u0119 upewni\u0107, sprawd\u017a warto\u015b\u0107 parametru <em>expiryTimeMillis <\/em>.<\/li>\n\n\n\n<li><em>cancelSurveyResult: <\/em><a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions#SubscriptionCancelSurveyResult\" target=\"_blank\" rel=\"noopener nofollow\"><em>Obiekt<\/em><\/a><em> kt\u00f3ry przechowuje pow\u00f3d anulowania subskrypcji, kt\u00f3ry b\u0119dzie obecny, je\u015bli u\u017cytkownik pozostawi\u0142 jakiekolwiek opinie w tej sprawie.<\/em><\/li>\n\n\n\n<li><em>introductoryPriceInfo<\/em>: <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions#IntroductoryPriceInfo\" target=\"_blank\" rel=\"noopener nofollow\">Obiekt<\/a> kt\u00f3ry przechowuje wst\u0119pne dane cenowe. Na przyk\u0142ad mo\u017ce to by\u0107 specjalna oferta na 1 miesi\u0105c z 50% zni\u017ck\u0105.<\/li>\n\n\n\n<li><em>promotionType<\/em>: Kod promocyjny, kt\u00f3ry zosta\u0142 u\u017cyty do aktywacji subskrypcji. Mo\u017cliwe warto\u015bci to:<br><strong><em>0:<\/em><\/strong><em> jednorazowy kod promocyjny.<br><\/em><strong><em>1: <\/em><\/strong><em>Masowy kod promocyjny, kt\u00f3ry mo\u017ce zosta\u0107 zastosowany przez wielu klient\u00f3w. Takie kody s\u0105 zwykle u\u017cywane przy wsp\u00f3\u0142pracy z blogerami.&nbsp;<\/em><\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>promotionCode<\/em>: masowy kod promocyjny, kt\u00f3ry zosta\u0142 u\u017cyty do aktywacji subskrypcji. Ten parametr nie jest obecny dla jednorazowych kod\u00f3w promocyjnych.&nbsp;<strong>\u200d<\/strong><\/li>\n\n\n\n<li>priceChange: <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions#SubscriptionPriceChange\" target=\"_blank\" rel=\"noopener nofollow\">Obiekt<\/a>, kt\u00f3ry przechowuje dane dotycz\u0105ce przysz\u0142ych zmian cen, a tak\u017ce czy u\u017cytkownik wyrazi\u0142 na to zgod\u0119.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"potwierdzenie-subskrypcji\">Potwierdzenie subskrypcji<\/h3>\n\n\n\n<p>Jak ju\u017c wspomniano powy\u017cej, <strong>je\u015bli subskrypcja nie zostanie potwierdzona w ci\u0105gu 3 dni od dokonania zakupu, zostanie automatycznie anulowana i zwr\u00f3cona<\/strong>. Szczerze m\u00f3wi\u0105c, nie bardzo rozumiem logik\u0119, kt\u00f3ra si\u0119 kryje w tym systemie, i nigdy nie spotka\u0142em si\u0119 z nim w innych systemach przetwarzania p\u0142atno\u015bci, w tym iOS. Mimo to, je\u015bli otrzymasz transakcj\u0119 zawieraj\u0105c\u0105 <em>acknowledgementState=0<\/em>, musisz potwierdzi\u0107 subskrypcj\u0119.<\/p>\n\n\n\n<p>Aby to zrobi\u0107, musisz wywo\u0142a\u0107 metod\u0119 <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions\/acknowledge\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.subscriptions.acknowledge<\/em><\/a>. Ta metoda wykonuje \u017c\u0105danie POST <\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"https:\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/subscriptions\/{subscriptionId}\/tokens\/{token}:acknowledge\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #D8DEE9FF\">https<\/span><span style=\"color: #81A1C1\">:<\/span><span style=\"color: #616E88\">\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/subscriptions\/{subscriptionId}\/tokens\/{token}:acknowledge<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Parametry s\u0105 takie same jak w przypadku walidacji \u017c\u0105dania. Je\u015bli \u017c\u0105danie zostanie pomy\u015blnie zrealizowane, subskrypcja zostanie potwierdzona, co oznacza, \u017ce nie stracisz pieni\u0119dzy.&nbsp;<\/p>\n\n\n\n<p>Je\u015bli subskrypcja nie zosta\u0142a jeszcze w pe\u0142ni zakupiona, nie ma potrzeby potwierdzania jej.&nbsp;<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"anulowanie-odwolanie-zwrot-i-odroczenie-odnowienia-subskrypcji\">Anulowanie, odwo\u0142anie, zwrot i odroczenie odnowienia subskrypcji<\/h3>\n\n\n\n<p>Opr\u00f3cz weryfikacji i potwierdzenia subskrypcji, Google Play Developer API mo\u017ce by\u0107 r\u00f3wnie\u017c u\u017cywane do innych operacji, zwi\u0105zanych z subskrypcjami. Nale\u017cy zauwa\u017cy\u0107, \u017ce s\u0105 one do\u015b\u0107 rzadkie i, z wyj\u0105tkiem odnowienia, s\u0105 obs\u0142ugiwane przez konsol\u0119 Google Play. Mimo tego wymieni\u0119 je, aby da\u0107 ci og\u00f3lne zrozumienie zakresu rozwi\u0105za\u0144 API. Wszystkie te \u017c\u0105dania maj\u0105 te same parametry wymagane jak wy\u017cej wymienione metody, a mianowicie, <em>packageName<\/em>, <em>subscriptionId<\/em>, oraz <em>token<\/em>.<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Anulowanie odnowienia (renewal cancellation). Metoda <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions\/cancel\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.subscriptions.cancel<\/em><\/a>. Anuluje automatyczne odnawianie wybranej subskrypcji. Subskrypcja b\u0119dzie jednak nadal dost\u0119pna przez ca\u0142y bie\u017c\u0105cy okres rozliczeniowy.<\/li>\n\n\n\n<li>Zwrot op\u0142aty za subskrypcj\u0119 (subscription refund). Metoda <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions\/refund\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.subscriptions.refund<\/em><\/a>. Dokonuje ona zwrotu op\u0142aty za subskrypcj\u0119. Jednak u\u017cytkownik nadal zachowa dost\u0119p do subskrypcji i zostanie ona automatycznie odnowiona w nast\u0119pnym okresie. W wi\u0119kszo\u015bci przypadk\u00f3w powiniene\u015b r\u00f3wnie\u017c odwo\u0142a\u0107 subskrypcj\u0119 przy dokonywaniu zwrotu pieni\u0119dzy.<\/li>\n\n\n\n<li>Odwo\u0142anie subskrypcji (subscription revocation). Metoda <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions\/revoke\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.subscriptions.revoke<\/em><\/a>. Natychmiast anuluje subskrypcj\u0119, co oznacza, \u017ce u\u017cytkownik nie b\u0119dzie m\u00f3g\u0142 uzyska\u0107 dost\u0119pu do funkcji premium. Subskrypcja nie zostanie odnowiona. Metoda ta jest zwykle wywo\u0142ywana wraz z dokonaniem zwrotu \u015brodk\u00f3w.<\/li>\n\n\n\n<li>Odroczenie zakupu subskrypcji (subscription purchase deferral). Metoda <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.subscriptions\/defer\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.subscriptions.defer<\/em><\/a>. Przed\u0142u\u017ca subskrypcj\u0119 do okre\u015blonej daty. W \u017c\u0105daniu okre\u015bl dat\u0119 wyga\u015bni\u0119cia subskrypcji, a tak\u017ce dat\u0119, na kt\u00f3r\u0105 chcesz j\u0105 zast\u0105pi\u0107. To ostatnie musi skutkowa\u0107 d\u0142u\u017cszym okresem subskrypcji ni\u017c poprzedni.<\/li>\n<\/ul>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"walidacja-produktu-nie-subskrypcji\">Walidacja produktu (nie subskrypcji)<\/h3>\n\n\n\n<p>Walidacja produktu jest podobna do walidacji subskrypcji. Musisz powo\u0142a\u0107 si\u0119 na metod\u0119 <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.products\/get\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.products.get<\/em><\/a> do wykonania \u017c\u0105dania GET.<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"https:\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/products\/{productId}\/tokens\/{token}\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #D8DEE9FF\">https<\/span><span style=\"color: #81A1C1\">:<\/span><span style=\"color: #616E88\">\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/products\/{productId}\/tokens\/{token}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Wszystkie te parametry znamy ju\u017c z powy\u017cszych przyk\u0142ad\u00f3w.<\/p>\n\n\n\n<p>Dane transakcji (dla produktu):<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"{\n  &quot;purchaseTimeMillis&quot;: &quot;1630529397125&quot;,\n  &quot;purchaseState&quot;: 0,\n  &quot;consumptionState&quot;: 0,\n  &quot;developerPayload&quot;: &quot;&quot;,\n  &quot;orderId&quot;: &quot;GPA.3374-2691-3583-90384&quot;,\n  &quot;acknowledgementState&quot;: 1,\n  &quot;kind&quot;: &quot;androidpublisher#productPurchase&quot;,\n  &quot;regionCode&quot;: &quot;RU&quot;\n}\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">purchaseTimeMillis<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">1630529397125<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">purchaseState<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #B48EAD\">0<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">consumptionState<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #B48EAD\">0<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">developerPayload<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">orderId<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">GPA.3374-2691-3583-90384<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">acknowledgementState<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #B48EAD\">1<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">kind<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">androidpublisher#productPurchase<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">regionCode<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">RU<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p><a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.products\" rel=\"nofollow noopener\" target=\"_blank\">Transakcje produktowe<\/a> zawieraj\u0105 znacznie mniej warto\u015bci, ni\u017c transakcje subskrypcyjne. Rzu\u0107my okiem na kilka wa\u017cnych:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>kind<\/em>: rodzaj transakcji. W produktach zawsze ma warto\u015b\u0107 <em>androidpublisher#productPurchase<\/em>. Dzi\u0119ki temu parametrowi mo\u017cesz zrozumie\u0107, czy masz do czynienia z subskrypcj\u0105, czy produktem, i odpowiednio wybra\u0107 logik\u0119 przetwarzania.<\/li>\n\n\n\n<li><em>purchaseState: <\/em>status p\u0142atno\u015bci. Zauwa\u017c, \u017ce kluczowe warto\u015bci tutaj r\u00f3\u017cni\u0105 si\u0119 od parametru dla subskrypcji <em>paymentState <\/em>. Mo\u017cliwe warto\u015bci to:<br><strong><em>0: <\/em><\/strong><em>zakup zosta\u0142 zako\u0144czony.<br><\/em><strong><em>1: <\/em><\/strong><em>zakup zosta\u0142 anulowany. Oznacza to, \u017ce zakup by\u0142 w toku, ale u\u017cytkownik nigdy za niego nie zap\u0142aci\u0142.<br><\/em><strong><em>2<\/em>:<\/strong> zakup jest w toku. W niekt\u00f3rych krajach u\u017cytkownik mo\u017ce zap\u0142aci\u0107 za subskrypcj\u0119 na oddzielnym urz\u0105dzeniu. Oznacza to, \u017ce u\u017cytkownik inicjuje zakup subskrypcji ze swojego urz\u0105dzenia, a p\u0142aci za ni\u0105 w pobliskim terminalu. Og\u00f3lnie rzecz bior\u0105c, jest to do\u015b\u0107 rzadki przypadek, ale nadal nale\u017cy o nim pami\u0119ta\u0107.<\/li>\n<\/ul>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>acknowledgementState<\/em>: status potwierdzenia zakupu. Jest to wa\u017cny parametr, kt\u00f3ry potwierdza, czy u\u017cytkownik otrzyma\u0142 dost\u0119p do tego, za co zap\u0142aci\u0142. Warto\u015b\u0107 &#8222;0&#8221; oznacza, \u017ce nie posiada dost\u0119pu, a &#8222;1&#8221; oznacza, \u017ce go ma. Deweloper jest odpowiedzialny za zdefiniowanie tego statusu, co mo\u017cna zrobi\u0107 zar\u00f3wno po stronie aplikacji mobilnej, jak i serwera. Je\u015bli nie potwierdzisz zakupu w ci\u0105gu 3 dni od jego dokonania, zostanie on automatycznie zwr\u00f3cony. Polecam wdro\u017cenie tej logiki: po otrzymaniu transakcji zawieraj\u0105cej <em>acknowledgementState=0<\/em>, parametr zostanie zmieniony przez serwer. Om\u00f3wi\u0119, jak to zrobi\u0107 poni\u017cej.&nbsp;<\/li>\n\n\n\n<li><em>consumptionState<\/em>: Stan u\u017cycia produktu. To w\u0142a\u015bnie iOS okre\u015bla jako &#8222;consumable&#8221;. Jest to zdefiniowane po stronie aplikacji mobilnej. Je\u015bli posiada warto\u015b\u0107 &#8222;0&#8221;, oznacza to, \u017ce produkt nie zosta\u0142 u\u017cyty; je\u015bli wynosi &#8222;<em>1&#8243;<\/em>, zosta\u0142 ju\u017c u\u017cyty. Je\u015bli sprzedajesz do\u017cywotni dost\u0119p do aplikacji lub okre\u015blon\u0105 funkcj\u0119 premium, taki produkt nie powinien by\u0107 u\u017cyty, to znaczy powinien posiada\u0107 status 0. Je\u015bli sprzedajesz monety, kt\u00f3re u\u017cytkownik mo\u017ce kupowa\u0107 regularnie, takie produkty powinny by\u0107 u\u017cywane, to znaczy powinny mie\u0107 status 1. <em>consumptionState=0<\/em> oznacza, \u017ce produkt mo\u017cna kupi\u0107 tylko raz, natomiast <em>consumptionState=1<\/em> oznacza, \u017ce mo\u017cna go kupi\u0107 wiele razy.<\/li>\n\n\n\n<li><em>orderId<\/em>: unikalny identyfikator transakcji. Ka\u017cdy zakup lub odnowienie subskrypcji b\u0119dzie posiada\u0142o sw\u00f3j w\u0142asny identyfikator, kt\u00f3ry mo\u017cna wykorzysta\u0107, aby dowiedzie\u0107 si\u0119, czy ta transakcja zosta\u0142a ju\u017c przetworzona wcze\u015bniej.<\/li>\n\n\n\n<li><em>purchaseTimeMillis<\/em>: data zakupu.<\/li>\n\n\n\n<li><em>regionCode<\/em>: kraj zakupu w formacie dwuliterowym, np. USA. Zauwa\u017c, \u017ce nazwa tego parametru jest inna ni\u017c w subskrypcjach, gdzie nazywa si\u0119 on <em>countryCode<\/em>.&nbsp;<\/li>\n\n\n\n<li><em>purchaseType<\/em>: rodzaj zakupu. Ten klucz nie b\u0119dzie obecny w wi\u0119kszo\u015bci przypadk\u00f3w. Jest nadal wa\u017cne, aby wzi\u0105\u0107 go pod uwag\u0119, poniewa\u017c pomaga on zrozumie\u0107, czy zakup zosta\u0142 dokonany w \u015brodowisku Sandbox. Mo\u017cliwe warto\u015bci to:<br><strong><em>0: <\/em><\/strong><em>zakup zosta\u0142 dokonany w \u015brodowisku Sandbox, dlatego nie powinien by\u0107 uwzgl\u0119dniany w danych analitycznych.<br><\/em><strong><em>1: <\/em><\/strong><em>zakup zosta\u0142 dokonany przy u\u017cyciu kodu promocyjnego.<br><\/em><strong><em>\u200d<\/em>2:<\/strong> zakup zosta\u0142 przyznany za okre\u015blone dzia\u0142anie, np. ogl\u0105danie reklamy w aplikacji zamiast p\u0142atno\u015bci.<\/li>\n<\/ul>\n\n\n\n<p>Jak wida\u0107, walidacja produktu jest bardzo podobna do walidacji subskrypcji. Jest jednak kilka punkt\u00f3w, na kt\u00f3re warto zwr\u00f3ci\u0107 uwag\u0119:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Cena nie jest zwracana, chocia\u017c by\u0142oby to do\u015b\u0107 przydatne dla analityki.<\/li>\n\n\n\n<li>Warto\u015bci parametru purchaseState znacznie r\u00f3\u017cni si\u0119 od warto\u015bci parametru <em>paymentState<\/em>, kt\u00f3ry mo\u017cna znale\u017a\u0107 w subskrypcjach. Spowoduje to b\u0142\u0119dy, je\u015bli nie we\u017amie si\u0119 tego pod uwag\u0119.&nbsp;<\/li>\n\n\n\n<li><em>regionCode<\/em> zostaje zwr\u00f3cony, mimo \u017ce jest nazywany <em>countryCode<\/em> w przypadku subskrypcji.<\/li>\n<\/ul>\n\n\n\n<p>Podobnie jak zakupy subskrypcji, zakupy produkt\u00f3w musz\u0105 zosta\u0107 potwierdzone. W tym celu nale\u017cy powo\u0142a\u0107 si\u0119 na metod\u0119 <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.products\/acknowledge\" target=\"_blank\" rel=\"noopener nofollow\"><em>purchases.products.acknowledge<\/em><\/a>, kt\u00f3ra wykona \u017c\u0105danie POST<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"https:\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/products\/{productId}\/tokens\/{token}:acknowledge\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #D8DEE9FF\">https<\/span><span style=\"color: #81A1C1\">:<\/span><span style=\"color: #616E88\">\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/products\/{productId}\/tokens\/{token}:acknowledge<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Je\u015bli zakup nie zosta\u0142 jeszcze sfinalizowany, nie ma potrzeby potwierdzania go.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\" id=\"sledzenie-zwrotow-za-subskrypcje-i-produkty\">\u015aledzenie zwrot\u00f3w za subskrypcje i produkty<\/h3>\n\n\n\n<p>Wysokiej jako\u015bci analityka jest niemo\u017cliwa bez rozliczania zwrot\u00f3w \u015brodk\u00f3w. Niestety dane zwrotu nie s\u0105 obecne w transakcji ani nie s\u0105 wy\u015bwietlane jako osobne zdarzenie (event), jak ma to miejsce w systemie iOS. Aby otrzyma\u0107 list\u0119 zwr\u00f3conych transakcji, musisz wywo\u0142a\u0107 <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.voidedpurchases\/list\" rel=\"nofollow noopener\" target=\"_blank\"><em>purchases.voidedpurchases.list<\/em><\/a> regularnie \u2014 na przyk\u0142ad raz dziennie. Ta metoda wykona \u017c\u0105danie GET:<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"https:\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/voidedpurchases\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #D8DEE9FF\">https<\/span><span style=\"color: #81A1C1\">:<\/span><span style=\"color: #616E88\">\/\/androidpublisher.googleapis.com\/androidpublisher\/v3\/applications\/{packageName}\/purchases\/voidedpurchases<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>W odpowiedzi na zapytanie otrzymasz list\u0119 wszystkich zwr\u00f3conych <a href=\"https:\/\/developers.google.com\/android-publisher\/api-ref\/rest\/v3\/purchases.voidedpurchases\" target=\"_blank\" rel=\"noopener nofollow\">transakcji<\/a>. Polecam wyszukiwanie transakcji w bazie przez parametr <em>orderId<\/em>, w przeciwie\u0144stwie do <em>purchaseToken<\/em>. Po pierwsze, zajmie to mniej czasu. Po drugie, wszystkie odnowienia subskrypcji b\u0119d\u0105 wsp\u00f3\u0142dzieli\u0107 ten sam token i wystarczy pobra\u0107 najnowszy.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"powiadomienia-serwera-server-notifications-o-transakcjach\">Powiadomienia serwera (server notifications) o transakcjach<\/h2>\n\n\n\n<p><a href=\"https:\/\/developer.android.com\/google\/play\/billing\/rtdn-reference\" target=\"_blank\" rel=\"noopener nofollow\">Powiadomienia serwera<\/a> (powiadomienia deweloper\u00f3w w czasie rzeczywistym) pomagaj\u0105 dowiedzie\u0107 si\u0119 o wydarzeniach, kt\u00f3re mia\u0142y miejsce po stronie Google, na twoim serwerze, do tego prawie na \u017cywo. Po ich skonfigurowaniu otrzymasz powiadomienia o nowych zakupach, odnowieniach, problemach z p\u0142atno\u015bciami itp. Mo\u017ce to pom\u00f3c w zbieraniu lepszych analiz, a tak\u017ce znacznie u\u0142atwi\u0107 zarz\u0105dzanie statusem subskrybenta.<\/p>\n\n\n\n<p>Aby rozpocz\u0105\u0107 otrzymywanie powiadomie\u0144 serwera, musisz utworzy\u0107 temat Google Cloud Pub\/Sub, kt\u00f3ry wy\u015ble powiadomienia na \u017c\u0105dany adres. Ten temat powinien zosta\u0107 wskazany w sekcji ustawie\u0144 monetyzacji konsoli Google Play. Szczeg\u00f3\u0142owy przewodnik zawieraj\u0105cy zrzuty ekranu mo\u017cna znale\u017a\u0107 w <a href=\"https:\/\/docs.adapty.io\/docs\/real-time-developer-notifications-rtdn\" target=\"_blank\" rel=\"noopener\">dokumentach Adapty<\/a>.<\/p>\n\n\n\n<p>Powiadomienie serwera:<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"{\n  &quot;message&quot;: {\n    &quot;data&quot;: &quot;eyJ2ZXJzaW9uIjoiMS4wIiwicGFja2FnZU5hbWUiOiJjb20uYWRhcHR5LnNhbXBsZV9hcHAiLCJldmVudFRpbWVNaWxsaXMiOiIxNjMwNTI5Mzk3MTI1Iiwic3Vic2NyaXB0aW9uTm90aWZpY2F0aW9uIjp7InZlcnNpb24iOiIxLjAiLCJub3RpZmljYXRpb25UeXBlIjo2LCJwdXJjaGFzZVRva2VuIjoiY2o3anAuQU8tSjFPelIxMjMiLCJzdWJzY3JpcHRpb25JZCI6ImNvbS5hZGFwdHkuc2FtcGxlX2FwcC53ZWVrbHlfc3ViIn19&quot;,\n    &quot;messageId&quot;: &quot;2829603729517390&quot;,\n    &quot;message_id&quot;: &quot;2829603729517390&quot;,\n    &quot;publishTime&quot;: &quot;2021-09-01T20:49:59.124Z&quot;,\n    &quot;publish_time&quot;: &quot;2021-08-04T20:49:59.124Z&quot;\n  },\n  &quot;subscription&quot;: &quot;projects\/935083\/subscriptions\/adapty-rtdn&quot;\n}\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">message<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">data<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">eyJ2ZXJzaW9uIjoiMS4wIiwicGFja2FnZU5hbWUiOiJjb20uYWRhcHR5LnNhbXBsZV9hcHAiLCJldmVudFRpbWVNaWxsaXMiOiIxNjMwNTI5Mzk3MTI1Iiwic3Vic2NyaXB0aW9uTm90aWZpY2F0aW9uIjp7InZlcnNpb24iOiIxLjAiLCJub3RpZmljYXRpb25UeXBlIjo2LCJwdXJjaGFzZVRva2VuIjoiY2o3anAuQU8tSjFPelIxMjMiLCJzdWJzY3JpcHRpb25JZCI6ImNvbS5hZGFwdHkuc2FtcGxlX2FwcC53ZWVrbHlfc3ViIn19<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">messageId<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">2829603729517390<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">message_id<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">2829603729517390<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">publishTime<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">2021-09-01T20:49:59.124Z<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">publish_time<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">2021-08-04T20:49:59.124Z<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">},<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">subscription<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">projects\/935083\/subscriptions\/adapty-rtdn<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Interesuje nas g\u0142\u00f3wnie klucz <em>danych <\/em>, zawieraj\u0105cy dane transakcji zakodowane za pomoc\u0105 base64. Klucz <em>messageId<\/em> mo\u017ce by\u0107 u\u017cywany do deduplikacji wiadomo\u015bci, dzi\u0119ki czemu nie trzeba przetwarza\u0107 zduplikowanych wiadomo\u015bci.&nbsp;<\/p>\n\n\n\n<p>Oto transakcja w powiadomieniu serwera:<\/p>\n\n\n\n<div class=\"wp-block-kevinbatdorf-code-block-pro\" data-code-block-pro-font-family=\"\" style=\"font-size:.875rem;line-height:1.25rem\"><span role=\"button\" tabindex=\"0\" data-code=\"{\n  &quot;version&quot;: &quot;1.0&quot;,\n  &quot;packageName&quot;: &quot;com.adapty.sample_app&quot;,\n  &quot;eventTimeMillis&quot;: &quot;1630529397125&quot;,\n  &quot;subscriptionNotification&quot;: {\n    &quot;version&quot;: &quot;1.0&quot;,\n    &quot;notificationType&quot;: 6,\n    &quot;purchaseToken&quot;: &quot;cj7jp.AO-J1OzR123&quot;,\n    &quot;subscriptionId&quot;: &quot;com.adapty.sample_app.weekly_sub&quot;\n  }\n}\" style=\"color:#d8dee9ff;display:none\" aria-label=\"Copy\" class=\"code-block-pro-copy-button\"><svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" style=\"width:24px;height:24px\" fill=\"none\" viewBox=\"0 0 24 24\" stroke=\"currentColor\" stroke-width=\"2\"><path class=\"with-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2m-6 9l2 2 4-4\"><\/path><path class=\"without-check\" stroke-linecap=\"round\" stroke-linejoin=\"round\" d=\"M9 5H7a2 2 0 00-2 2v12a2 2 0 002 2h10a2 2 0 002-2V7a2 2 0 00-2-2h-2M9 5a2 2 0 002 2h2a2 2 0 002-2M9 5a2 2 0 012-2h2a2 2 0 012 2\"><\/path><\/svg><\/span><pre class=\"shiki nord\" style=\"background-color: #2e3440ff\"><code><span class=\"line\"><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">version<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">1.0<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">packageName<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">com.adapty.sample_app<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">eventTimeMillis<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">1630529397125<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">subscriptionNotification<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">{<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">version<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">1.0<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">notificationType<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #B48EAD\">6<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">purchaseToken<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">cj7jp.AO-J1OzR123<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">,<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">    <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #8FBCBB\">subscriptionId<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #ECEFF4\">:<\/span><span style=\"color: #D8DEE9FF\"> <\/span><span style=\"color: #ECEFF4\">&quot;<\/span><span style=\"color: #A3BE8C\">com.adapty.sample_app.weekly_sub<\/span><span style=\"color: #ECEFF4\">&quot;<\/span><\/span>\n<span class=\"line\"><span style=\"color: #D8DEE9FF\">  <\/span><span style=\"color: #ECEFF4\">}<\/span><\/span>\n<span class=\"line\"><span style=\"color: #ECEFF4\">}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n<p>Klucz <em>packageName<\/em> pomaga zrozumie\u0107, do kt\u00f3rej aplikacji nale\u017cy to wydarzenie. Klucz <em>subscriptionId<\/em> m\u00f3wi Ci, kt\u00f3ra subskrypcja jest zaanga\u017cowana, a <em>purchaseToken <\/em>pomaga znale\u017a\u0107 konkretn\u0105 transakcj\u0119. W przypadku subskrypcji zawsze b\u0119dziesz szuka\u0142 ostatniej transakcji w \u0142a\u0144cuchu odnowienia, poniewa\u017c jest to ta, do kt\u00f3rej b\u0119dzie nale\u017ce\u0107 to wydarzenie. Klucz <em>notificationType <\/em>zawiera <a href=\"https:\/\/developer.android.com\/google\/play\/billing\/rtdn-reference#sub\" target=\"_blank\" rel=\"noopener nofollow\">typ zdarzenia<\/a>. Moim zdaniem poni\u017csze s\u0105 najbardziej przydatne dla subskrypcji:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>(2) SUBSCRIPTION_RENEWED<\/em>: subskrypcja zosta\u0142a pomy\u015blnie odnowiona.<\/li>\n\n\n\n<li><em>(3) SUBSCRIPTION_CANCELED<\/em>: u\u017cytkownik wy\u0142\u0105czy\u0142 automatyczne odnawianie subskrypcji. Je\u015bli automatyczne odnawianie jest wy\u0142\u0105czone, musisz spr\u00f3bowa\u0107 przywr\u00f3ci\u0107 u\u017cytkownika jako aktywnego subskrybenta.<\/li>\n\n\n\n<li><em>(5) SUBSCRIPTION_ON_HOLD<\/em>,<em> (6) SUBSCRIPTION_IN_GRACE_PERIOD<\/em>: subskrypcja nie mog\u0142a zosta\u0107 odnowiona z powodu problem\u00f3w z p\u0142atno\u015bci\u0105. Powiniene\u015b powiadomi\u0107 o tym u\u017cytkownika, aby jego subskrypcja nie zosta\u0142a automatycznie anulowana.<\/li>\n\n\n\n<li><em>(12) SUBSCRIPTION_REVOKED<\/em>: subskrypcja zosta\u0142a odwo\u0142ana. Oznacza to, \u017ce u\u017cytkownik powinien utraci\u0107 dost\u0119p do funkcji premium przyznanych wcze\u015bniej w ramach subskrypcji.&nbsp;<\/li>\n<\/ul>\n\n\n\n<p>Dla produkt\u00f3w (nie subskrypcji) otrzymasz <em>oneTimeProductNotification <\/em>w miejsce klucza <em>subscriptionNotification<\/em>. B\u0119dzie on r\u00f3wnie\u017c zawiera\u0142 klucz sku zamiast klucza subscriptionId. Co wi\u0119cej, otrzymasz tylko 2 <a href=\"https:\/\/developer.android.com\/google\/play\/billing\/rtdn-reference#one-time\" target=\"_blank\" rel=\"noopener nofollow\">rodzaje zdarze\u0144<\/a> dla produkt\u00f3w:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><em>(1) ONE_TIME_PRODUCT_PURCHASED<\/em>: udany zakup produktu.<\/li>\n\n\n\n<li><em>(2) ONE_TIME_PRODUCT_CANCELED<\/em>: zakup produktu zosta\u0142 anulowany, poniewa\u017c u\u017cytkownik nie zap\u0142aci\u0142 za niego.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"wnioski\">Wnioski<\/h2>\n\n\n\n<p>Walidacja po stronie serwera wspomaga dane analityczne, kt\u00f3re b\u0119dziesz m\u00f3g\u0142 zbiera\u0107 dla swojej aplikacji. Utrudnia ona oszustom dost\u0119p do tre\u015bci premium i mo\u017ce by\u0107 wykorzystywana do realizacji subskrypcji mi\u0119dzy platformami. Jednak walidacja po stronie serwera mo\u017ce potrwa\u0107 sporo czasu, zw\u0142aszcza je\u015bli wymagana jest wysoka dok\u0142adno\u015b\u0107 danych. Aby zapewni\u0107 wysokiej jako\u015bci dane, musisz uwzgl\u0119dni\u0107 wiele mo\u017cliwych przypadk\u00f3w, takich jak aktualizacja subskrypcji, zmiany poziomu subskrypcji, okresy pr\u00f3bne, oferty promocyjne i wprowadzaj\u0105ce, okres karencji, zwroty itp. Musisz tak\u017ce zna\u0107 i uwzgl\u0119dnia\u0107 wszystkie zasady, takie jak, \u017ce Google pobiera tylko 15% (zamiast 30%) prowizji od subskrypcji, kt\u00f3re s\u0105 odnawiane na ponad rok.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Pi\u0105ty samouczek z naszej serii po\u015bwi\u0119cony jest implementacji zakup\u00f3w w aplikacjach na Androida<\/p>\n","protected":false},"author":43,"featured_media":143027,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[988],"tags":[],"page-builder":[],"class_list":["post-137902","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorial-pl"],"acf":[],"_links":{"self":[{"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/posts\/137902","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/users\/43"}],"replies":[{"embeddable":true,"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/comments?post=137902"}],"version-history":[{"count":0,"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/posts\/137902\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/media\/143027"}],"wp:attachment":[{"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/media?parent=137902"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/categories?post=137902"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/tags?post=137902"},{"taxonomy":"page-builder","embeddable":true,"href":"https:\/\/adapty.io\/pl\/wp-json\/wp\/v2\/page-builder?post=137902"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}