Zarządzanie zamówieniami podręcznik integracji

Transkrypt

1 Zarządzanie zamówieniami podręcznik integracji Wyłącznie do zastosowań profesjonalnych Aktualnie dostępny jedynie w języku angielskim. A usage Professional Uniquement Disponible en Anglais uniquement pour l'instant. Ostatnia aktualizacja: lipiec 2006

2 Zarządzanie zamówieniami w systemie PayPal podręcznik integracji 2006 PayPal, Inc. Wszelkie prawa zastrzeżone. PayPal i logo PayPal są zarejestrowanymi znakami towarowymi firmy PayPal Inc. Inne znaki towarowe i marki należą do odpowiednich właścicieli. Informacje zawarte w niniejszym dokumencie stanowią własność firmy PayPal Inc.. Nie można ich używać, powielać lub ujawniać bez pisemnej zgody firmy PayPal Inc. Firma PayPal (Europe) Ltd. posiada upoważnienie do prowadzenia działalności w Wielkiej Brytanii i jako instytucja pieniądza elektronicznego podlega nadzorowi sprawowanemu przez Financial Services Authority (Urząd Nadzoru Finansowego). Numer rejestracyjny firmy PayPal w FSA: Informacja o braku odpowiedzialności: Firma PayPal Inc. przekazuje użytkownikowi informacje zawarte w niniejszym dokumencie w stanie, w jakim się znajdują z wszystkimi błędami. Firma PayPal Inc. nie daje żadnych gwarancji (wyrażonych jednoznacznie, dorozumianych lub ustawowych) w zakresie informacji tutaj zawartych. Firma PayPal Inc. nie ponosi żadnej odpowiedzialności za szkody (bezpośrednie lub pośrednie) spowodowane błędami, brakami lub wynikające z korzystania z niniejszego dokumentu lub informacji w nim zawartych, a także wynikających ze stosowania lub używania produktów lub usług w nim opisanych. Firma PayPal, Inc. zastrzega sobie prawo do modyfikacji dowolnych informacji tutaj zawartych bez dalszego powiadomienia. Firma PayPal, Inc. nie gwarantuje, że funkcje opisane w niniejszym dokumencie będą zaprezentowane lub udostępnione komukolwiek w przyszłości.

3 Spis treści Wstęp Ten dokument Grupa docelowa Struktura niniejszego dokumentu Konwencje zapisu Problemy z dokumentacją Historia zmian Rozdział 1 Wprowadzenie Adres Raportowanie Różnice między usługami Błyskawiczne powiadamianie o płatności (BPP) i Przesłanie danych na temat płatności (PDP) Szyfrowanie SLL nie jest wymagane w przypadku BPP Waluty obsługiwane przez serwis PayPal Rozdział 2 Przesłanie danych na temat płatności W jaki sposób działa PDT Uruchamianie usługi Przesłanie danych na temat płatności Otrzymywanie tokenu identyfikacyjnego i korzystanie z niego PDT i Niewymagane konto PayPal Synchronizacja powiadomień PDT Tworzenie polecenia POST Odpowiedź PayPal na polecenie POST Funkcja PDT i automatyczny powrót: komunikaty do kupującego Zapobieganie oszustwom Przykłady kodu Rozdział 3 Błyskawiczne powiadamianie o płatności Konfigurowanie funkcji BPP Uaktywnienie funkcji BPP Konfigurowanie programu przetwarzającego powiadomienia BPP lipiec

4 Spis treści Zatwierdzanie powiadomienia: zapobieganie oszustwom Poufna informacja współdzielona przypadająca na transakcję lub ustawienie na podkarcie Profil Weryfikacja oparta na współdzieleniu poufnej informacji Formularz zwrotny HTTPS wysyłany do systemu PayPal Korzystanie z wielowalutowych powiadomień BPP Zmienne payment_gross i payment_fee Przykłady wielowalutowych zmiennych BPP Powiadomienie o sporze Rozdział 4 Historia transakcji i narzędzia raportowania Miesięczne wyciągi z rachunku Przeszukiwanie historii w trybie online Wyszukiwanie podstawowe: okresy czasowe Wyszukiwanie zaawansowane: pola kluczowe Pobierz historię Wybieranie zakresu dat Wybieranie formatu pliku oraz kategorii transakcji Zakończone transakcje od ostatniego pobrania Dostosowywanie pobierania: Wybieranie pól transakcji Uzgadnianie zobowiązań dotyczących transakcji wraz z Kolumną wpływu na saldo Cykl transakcyjny: Status Kolumna kwoty netto Zestawienie transakcji spornych Programowy dostęp do zestawienia transakcji spornych Załącznik A Zmienne BPP i PDP Tabele zmiennych informacje Wartości zmiennej dla danej transakcji Zmienna test_ipn w centrum testowym Zmienne BPP we wszystkich wiadomościach Wersja BPP: notify_version Informacje dotyczące bezpieczeństwa: verify_sign Informacje o kupującym Informacje podstawowe Informacje zaawansowane i niestandardowe Informacje dotyczące Płatności za pośrednictwem witryny oraz zwrotów lipiec 2006

5 Spis treści Waluta i wymiana walut Aukcje Płatność zbiorcza Zmienne subskrypcji Zmienne dla każdego zdarzenia subskrypcji Zmienne payment_status i txn_type z BPP subskrypcji Zmienne powiadomienia o sporze Różne zmienne oraz zmienne BPP związane z opłatami Zmienne typowe dla PDP Załącznik B Rejestr historii transakcji do pobrania Kolumny i zmienne Załącznik C Kody krajów Indeks lipiec

6 Spis treści 6 lipiec 2006

7 Lista tabel Tabela 1.1 Historia zmian Tabela 1.1 Waluty obsługiwane w systemie PayPal, kody walut oraz maksymalne kwoty transakcji Tabela 4.1 Wyszukiwanie w trybie online: rodzaje działań do wyboru Tabela 4.2 Zaawansowane wyszukiwanie transakcji: pola kluczowe Tabela A.1 Zmienne BPP i PDP: informacje o kupującym Tabela A.2 Zmienne BPP i PDP: informacje podstawowe Tabela A.3 Zmienne BPP i PDP: informacje zaawansowane i niestandardowe Tabela A.4 Zmienne BPP i PDP: informacje dotyczące Płatności za pośrednictwem witryny oraz zwrotów Tabela A.5 Zmienne BPP i PDP: informacje dotyczące walut i wymiany walut Tabela A.6 Zmienne BPP i PDP: aukcje Tabela A.7 Zmienne BPP i PDP: płatność zbiorcza Tabela A.8 Zmienne subskrypcji Tabela A.9 Zmienne BPP dla każdego zdarzenia subskrypcji Tabela A.10 Zmienne powiadomienia o sporze Tabela A.11 Rożne zmienne BPP związane z opłatami Tabela A.12 Zmienne typowe dla PDP Tabela B.1 Kolumny i zmienne rejestru historii transakcji do pobrania lipiec

8 Lista tabel 8 lipiec 2006

9 Lista rysunków Rysunek 3.1 Jak działa BBP: trzy kroki podstawowe Rysunek 4.1 Strona Historia Rysunek 4.2 Pobierz historię Rysunek 4.3 Dostosuj pobieranie mojej historii Rysunek 4.4 Obliczenia kwot brutto, opłat oraz kwot netto za pomocą Rejestru historii Rysunek 4.5 Zestawienie transakcji spornych lipiec

10 Lista rysunków 10 lipiec 2006

11 Wstęp Ten dokument To wydanie Zarządzanie zamówieniami w systemie PayPal podręcznik integracji stanowi dokument, który opisuje funkcje zarządzania zamówieniami w systemie PayPal, takie jak Przesłanie danych na temat płatności (PDP), Błyskawiczne powiadamianie o płatności (BPP) oraz Rejestr historii do pobrania i zastępuje wersję wydaną w grudniu Niniejszy dokument zastępuje fragmenty Podręcznika handlowca PayPal i Podręcznika integracji, które zostały wydane w kwietniu Grupa docelowa Niniejszy dokument został napisany dla handlowców, którzy korzystają z systemu PayPal w celu zarządzania informacjami dotyczącymi zamówień. Struktura niniejszego dokumentu Rozdział 1, Wprowadzenie zawiera krótki opis funkcji systemu PayPal dla celów zarządzania zamówieniami, które zostały omówione w tym podręczniku. Rozdział 2, Przesłanie danych na temat płatności opisuje działanie funkcji Przesłanie danych na temat płatności oraz jej konfigurację. Rozdział 3, Błyskawiczne powiadamianie o płatności opisuje działanie funkcji Błyskawiczne powiadomienie o płatności oraz jej konfigurację. Rozdział 4, Historia transakcji i narzędzia raportowania opisuje miesięczne wyciągi z rachunku, wyszukiwanie transakcji online, rejestr historii transakcji do pobrania oraz zestawienie transakcji spornych. Załącznik A, Zmienne BPP i PDP szczegółowy opis wszystkich zmiennych i wartości zwracanych przez funkcje Błyskawiczne powiadamianie o płatności oraz Przesłanie danych na temat płatności. Załącznik B, Rejestr historii transakcji do pobrania Kolumny i zmienne opisuje kolumny iwartości, które mogą być przedstawione w rejestrze historii transakcji do pobrania. lipiec

12 Wstęp Konwencje zapisu Konwencje zapisu W niniejszym dokumencie zastosowano różne kroje czcionek w celu podkreślenia charakterystycznych cech tekstu. Te kroje czcionek oraz związane z nimi cechy charakterystyczne zostały opisane poniżej: Krój czcionki serif italics Zastosowanie Tytuł dokumentu. Trwa omawianie lub definiowanie pojęcia. Na przykład: Plik jest czytelnym lub zapisywalnym ciągiem znaków... Wartości logiczne (nie słowa kluczowe). Na przykład: Funkcja zwraca wartość true, jeśli wystąpi błąd. monospaced Nazwy ścieżek lub plików, które pojawiają się w ramkach treści tekstu. Nazwy powiązane z kodem, które pojawiają się w ramkach treści tekstu. Nazwy takie używane są dla funkcji, wywołań zwrotnych, argumentów, struktur danych i pól. Na przykład: AbstractResponseType stanowi definicję typu odpowiedzi SOAP, na której bazują wszystkie metody odpowiedzi API w systemie PayPal. Składniki pytań i odpowiedzi protokołu internetowego, takie jak zmienne HTTPS i FORM. Na przykład: System PayPal korzysta z polecenia method=post, aby zwrócić zmienne statusu BPP związane z subskrypcjami, takie jak txn_type. Serif bold San-serif oblique Nazwy interfejsu użytkownika, takie jak nazwy okien lub pozycje menu. Na przykład: Na stronie Profil kliknij opcję , aby potwierdzić adres . Symbole zastępcze wykorzystywane w ramach formatu, standardu programowania lub formalnych opisów syntaksy systemu PayPal. Symbole zastępcze wskazują na wartości lub nazwy, które powinien dostarczyć czytelnik. Przykład: Na przykład amount jest zmienną dla koszyka pojedynczego przedmiotu, ale amount_x jest nazwą zmiennej dla koszyka wielu przedmiotów. amount_3 jest kwotą dla trzeciego przedmiotu w koszyku wielu przedmiotów. W celu przekazania dodatkowych informacji w niniejszym dokumencie mogły również zostać użyte kolory lub podkreślenia słów albo wyrażeń, dla których wykorzystywane są kroje czcionek opisane powyżej. Sposób ich zastosowania został opisany poniżej: Atrybut tekstu xxxxxx xxxxxx Zastosowanie Łącze hipertekstowe do strony w bieżącym dokumencie lub do innego dokumentu w zestawie. Łącze hipertekstowe do adresu URL lub do takiego, który inicjuje działanie witryny, jak w przypadku wysyłania wiadomości lipiec 2006

13 Wstęp Problemy z dokumentacją Problemy z dokumentacją Jeżeli użytkownik odkryje jakieś błędy lub będzie miał jakiekolwiek problemy z tą dokumentacją, prosimy o napisanie do nas pocztą elektroniczną zgodnie z instrukcjami poniżej. Należy w sposób jak najbardziej wyczerpujący opisać błąd lub problem oraz podać nam tytuł dokumentu, datę dokumentu (umieszczoną w stopce każdej strony) oraz numer strony lub zakres stron. Aby skontaktować się z obsługą klienta w sprawie problemów dotyczących dokumentacji: 1. Przejdź na stronę 2. Kliknij Pomoc w lewym górnym rogu strony. 3. Kliknij Kontakt z nami po lewej stronie na dole strony. 4. Wybierz Skontaktuj się z obsługą klienta systemu PayPal. 5. Wypełnij formularz. Historia zmian Historia zmian dla Zarządzanie zamówieniami w systemie PayPal podręcznik integracji. TABELA 1.1 Historia zmian Data lipiec 2006 maj 2006 Opis Niewielkie korekty wartości zmiennej BPP payment_status Opis Zestawienia transakcji spornych do wyszukania za pomocą narzędzi programowania. Dodatkowe wartości zmiennej Błyskawiczne powiadamianie opłatności (BPP) dla txn_type: merch-pmt w przypadku miesięcznej opłaty Płatności za pośrednictwem witryny i korekty w wyniku rozstrzygniętego sporu z koniecznością obciążenia zwrotnego. lipiec

14 Wstęp Historia zmian 14 lipiec 2006

15 1 Wprowadzenie Firma PayPal oferuje cztery metody powiadamiania o płatności do celów integracji wewnętrznej: Adres Narzędzia tworzenia raportów Błyskawiczne powiadamianie o płatności Przesłanie danych na temat płatności (PDP) Adres W następujących przypadkach otrzymasz powiadomienie pocztą Pomyślne dokonanie płatności Oczekująca płatność Płatność anulowana Jeśli nie chcesz otrzymywać powiadomień dotyczących płatności za pomocą poczty 1. Kliknij podkartę Profil na karcie Moje konto 2. Kliknij łącze Powiadomienia w kolumnie Informacje o koncie. 3. Znajdź nagłówek Powiadomienia dotyczące płatności i odznacz pole wyboru Otrzymuję płatności za pośrednictwem witryny i korzystam z zakupów błyskawicznych. 4. Kliknij przycisk Zapisz. Raportowanie Narzędzia raportowania firmy PayPal zapewniają dostęp do informacji, które pozwalają efektywnie monitorować wyniki i zarządzać firmą. Narzędzia raportowania firmy PayPal umożliwiają: analizę źródeł dochodów w celu lepszego zrozumienia działań kupujących, automatyzację czasochłonnych zadań związanych z księgowością, prawidłowe rozliczanie i uzgadnianie transakcji. lipiec

16 Wprowadzenie Różnice między usługami Błyskawiczne powiadamianie o płatności (BPP) i Przesłanie danych na temat Dostępne sprawozdania: Miesięczne wyciągi z rachunku: wyświetlanie miesięcznego podsumowania wszystkich uznań i obciążeń konta. Raporty ze sprzedaży osiągniętej przez handlowca: możliwość cotygodniowego otrzymywania cennej analizy przychodów w podziale na kanał sprzedaży i walutę. Rejestr historii: wyświetlanie elektronicznego zestawienia wysłanych i otrzymanych płatności Rejestr do pobrania: historia transakcji dostępna do pobrania w różnych formatach plików (na potrzeby rozliczeń finansowych). Szczegółowe informacje na temat raportów w systemie PayPal można znaleźć na stronie Różnice między usługami Błyskawiczne powiadamianie opłatności (BPP) i Przesłanie danych na temat płatności (PDP). Podstawowym zadaniem usługi Przesłanie danych na temat płatności jest wyświetlanie kupującym szczegółowych informacji dotyczących transakcji płatności po tym, jak zostali automatycznie przekierowani z powrotem do Twojej witryny w momencie zakończenia realizacji płatności; są jednak przypadki, kiedy nie otrzymasz powiadomienia o wszystkich transakcjach, jak np. w przypadku transakcji oczekujących, zwrotów środków lub cofnięć. Wzwiązku z tym lub w przypadku, gdy korzystasz z tych danych do realizacji zamówień, firma PayPal zdecydowanie zaleca włączenie również usługi Błyskawiczne powiadamianie opłatności (BPP). Zarówno w przypadku usługi Błyskawiczne powiadamianie o płatności (BPP) jak i Przesłanie danych na temat płatności (PDP), przesyłane są te same dane; jest jednak kilka znaczących różnic. PDP: Wymaga włączonej funkcji Automatyczny powrót. Funkcja Automatyczny powrót będzie stosować numer identyfikacyjny, dzięki któremu będzie można zwrócić się do PayPal o pełne szczegóły transakcji. Powiadomienie może zostać przegapione, jeśli użytkownik zamknie przeglądarkę, zanim nastąpi przekierowanie. BPP: Nie wymaga włączonej funkcji Automatyczny powrót. Na końcu procesu płatności za pośrednictwem witryny z systemu PayPal są wysyłane (POST) dane BPP w sposób niezsynchronizowany (tj. nie w ramach procesu płatności za pośrednictwem witryny). BPP spowoduje również wysłanie danych dotyczących rozliczenia czeków elektronicznych, cofnięć i zwrotów. 16 lipiec 2006

17 Wprowadzenie Waluty obsługiwane przez serwis PayPal Szyfrowanie SLL nie jest wymagane w przypadku BPP Ponieważ informacje bankowe i dotyczące karty kredytowej nie są przesyłane w ramach funkcji Błyskawiczne powiadamianie o płatności, system PayPal nie wymaga protokołu internetowego SSL w celu szyfrowania transmisji danych BPP. Waluty obsługiwane przez serwis PayPal Następujące waluty są obsługiwane przez serwis PayPal. TABELA 1.1 Waluty obsługiwane w systemie PayPal, kody walut oraz maksymalne kwoty transakcji Kod Waluta Maksymalna kwota transakcji AUD Dolar australijski AUD CAD Dolar kanadyjski CAD EUR Euro 8000 EUR GBP Funt szterling 5500 GBP JPY Japoński jen JPY USD Dolar amerykański USD lipiec

18 Wprowadzenie Waluty obsługiwane przez serwis PayPal 18 lipiec 2006

19 2 Przesłanie danych na temat płatności Funkcja Przesłanie danych na temat płatności (PDT) umożliwia handlowcom wyświetlanie szczegółów transakcji w przypadku kupujących, którzy są przekierowywani do witryny handlowca po dokonaniu płatności. UWAGA: Aby korzystać z tej funkcji, użytkownik powinien włączyć funkcję Automatyczny powrót na stronie Płatności za pośrednictwem witryny. Funkcja Automatyczny powrót przenosi kupujących z powrotem do witryny natychmiast po zakończeniu przez nich płatności. Funkcja Automatyczny powrót dotyczy wszystkich oferowanych przez PayPal usług Płatności za pośrednictwem witryny, włączając w to usługi Kup teraz, Darowizna, Subskrypcja oraz Koszyk. Aby uzyskać więcej informacji na temat funkcji Automatyczny powrót, zobacz Płatności za pośrednictwem witryny podręcznik integracji W jaki sposób działa PDT Czesław zamierza dokonać zakupu przyrządu w firmie Globe Industries. Krok 1: Czesław udaje się na stronę firmy Globe Industries, wybiera pożądany wihajster, anastępnie klika przycisk Kup teraz. lipiec

20 Przesłanie danych na temat płatności W jaki sposób działa PDT Krok 2: System przekierowuje Czesława na stronę serwisu PayPal zawierającą Szczegóły dotyczące płatności, na której są wyświetlane szczegóły dotyczące płatności, której za chwilę dokona. Krok 3: Czesław wprowadza informacje dotyczące swojego konta PayPal w polach logowania użytkownika PayPal. 20 lipiec 2006

21 Przesłanie danych na temat płatności W jaki sposób działa PDT Krok 4: System zabiera Czesława na stronę potwierdzenia, na której są wyświetlane szczegółowe informacje dotyczące dokonanego wyboru, sposobu finansowania automatycznych płatności oraz informacje dotyczące wysyłki. Czesław klika przycisk Zapłać w celu dokonania płatności. lipiec

22 Przesłanie danych na temat płatności W jaki sposób działa PDT Krok 5: Czesław zobaczy stronę potwierdzenia płatności z informacją o zakończeniu transakcji oraz o tym, że zostanie przekierowany z powrotem na stronę internetową firmy Globe Industries. Krok 6: Token transakcji, dostarczony przez firmę Globe Industries, przekazywany jest pod zwrotny adres URL. Firma Globe Industries pobiera token transakcji i odbiera szczegóły dotyczące transakcji za pomocą polecenia HTTP POST z systemu PayPal. W poleceniu HTTP POST zawarty jest token identyfikacyjny, przyznany firmie Globe Industries podczas aktywacji PDT. Aby uzyskać więcej informacji na temat tokenu identyfikacyjnego PDT, zobacz Otrzymywanie tokenu identyfikacyjnego i korzystanie z niego na stronie 24. Aby uzyskać więcej informacji na temat polecenia HTTP POST, zobacz Synchronizacja powiadomień PDT na stronie 26. Krok 7: Pojawia się strona podziękowania firmy Globe Industries, zawierająca informacje dotyczące transakcji i ponownie informująca Czesława o pomyślnym zakończeniu transakcji oraz o tym, że potwierdzenie transakcji zostało do niego wysłane pocztą elektroniczną. Na stronie są także wyświetlane szczegóły dotyczące płatności, łącze do witryny PayPal, z którego Czesław może skorzystać, jeśli zechce zobaczyć więcej szczegółów transakcji, oraz łącza, za pomocą których może kontynuować zakupy. Przykład znajduje się na poniższej ilustracji: Dziękujemy za dokonanie płatności. Transakcja została zakończona, a potwierdzenie przyjęcia zakupu zostało wysłane w wiadomości lipiec 2006

23 Przesłanie danych na temat płatności Uruchamianie usługi Przesłanie danych na temat płatności Aby wyświetlić szczegóły dotyczące tej transakcji, zaloguj się do konta na stronie Krok 8: Czesław otrzymuje potwierdzenie transakcji, która potwierdza dokonany przez niego zakup i zawiera kopię szczegółów płatności, informacje o firmie Globe Industries oraz potwierdzony adres wysyłki Czesława. Uruchamianie usługi Przesłanie danych na temat płatności Aby uruchomić PDT: 1. Kliknij kartę Moje konto. 2. Kliknij podkartę Profil. lipiec

24 Przesłanie danych na temat płatności Uruchamianie usługi Przesłanie danych na temat płatności 3. Kliknij łącze Preferencje płatności za pośrednictwem witryny, jak pokazano na poniższym rysunku. Zostanie otwarta strona Preferencje płatności za pośrednictwem witryny. 4. Kliknij przycisk radiowy Przesłanie danych na temat płatności Włącz tak, jak pokazano na poniższym rysunku. Użytkownik musi włączyć funkcję Automatycznego powrotu, aby korzystanie z usługi Przesłanie danych na temat płatności było możliwe. Automatyczny powrót można włączyć z poziomu strony Preferencje płatności za pośrednictwem witryny. 5. Kliknij przycisk Zapisz. Otrzymywanie tokenu identyfikacyjnego i korzystanie z niego Po kliknięciu przycisku Zapisz i zapisaniu preferencji dotyczących PDT w górnej części strony pojawi się wiadomość informująca o pomyślnym zakończeniu zapisywania preferencji. W wiadomości tej pojawi się również token identyfikacyjny użytkownika. 24 lipiec 2006

25 Przesłanie danych na temat płatności PDT i Niewymagane konto PayPal Ten token identyfikacyjny należy przekazać do systemu PayPal wraz z tokenem transakcji, co umożliwi otrzymanie informacji o pomyślnym zakończeniu płatności. Dla bezpieczeństwa token identyfikacyjny nie jest wysyłany do użytkownika; jednak po uruchomieniu PDT, jest on stale widoczny pod przyciskami Włącz/Wyłącz Przesłanie danych na temat płatności, na stronie Preferencje płatności za pośrednictwem witryny. PDT i Niewymagane konto PayPal Po włączeniu funkcji Niewymagane konto PayPal klienci będący nowymi użytkownikami w systemie PayPal nie będą musieli zakładać konta, aby dokonać płatności w systemie będą oni mogli zrealizować transakcję w sposób alternatywny i skorzystać z opcji zarejestrowania w późniejszym terminie. Klienci posiadający konto PayPal będą korzystać z jego zalet na dotychczasowych warunkach, w tym z historii płatności i ze zintegrowania z serwisem aukcyjnym ebay. Funkcja niewymaganego konta PayPal jest dostępna dla przycisków Kup teraz, Darowizny i Koszyk, natomiast nie można jej używać do przycisków Subskrypcji. Niewymagane konto PayPal dla kupujących jest włączone domyślnie. Jeśli handlowiec włączył funkcję Przesłanie danych na temat płatności i nie wyłączył funkcji Niewymagane konto PayPal, nowy użytkownik nie będzie automatycznie kierowany z powrotem do witryny, ale będzie miał możliwość powrotu. W chwili, gdy kupujący kliknie przycisk Kontynuuj, przesyłany jest numer identifykacyjny transakcji przypisany do tej transakcji. Handlowiec zwraca numer identifikacyjny transakcji wraz z odpowiednim tokenem identyfikacyjnym, po czym system PayPal przesyła mu informację dotyczącą płatności, potwierdzającą dokonanie płatności. Kupujący jest przekierowywany z powrotem na witrynę handlowca, gdzie są wyświetlane informacje dotyczące transakcji. Jeśli jednak kupujący nie kliknie przycisku Kontynuuj, przekierowanie na stronę handlowca nie nastąpi, a funkcja PDT nie zostanie uruchomiona. lipiec

26 Przesłanie danych na temat płatności Synchronizacja powiadomień PDT Synchronizacja powiadomień PDT Po uaktywnieniu funkcji PDT za każdym razem, gdy kupujący dokona płatności za pośrednictwem witryny i zostanie przekierowany pod zwrotny adres URL, pod ten adres URL zostanie wysłany token transakcji za pomocą polecenia FORM GET. Aby prawidłowo korzystać z funkcji PDT i umożliwić klientowi wyświetlenie szczegółów transakcji, należy odczytać token transakcji ze zmiennej tx oraz pobrać szczegóły dotyczące transakcji z systemu PayPal, wysyłając do niego żądanie tworzące HTTPS POST. Działanie to nazywane jest synchronizacją powiadomień lub po prostu synchronizacją. Tworzenie polecenia POST Oto wytyczne tworzenia żądania HTTPS POST funkcji PDT do systemu PayPal w celu synchronizacji powiadomień: 1. POST użytkownika musi zostać wysłany na adres 2. W żądaniu musi znajdować się zmienna cmd z wartością _notify-synch: cmd=_notify-synch 3. W zmiennej tx musi znajdować się token transakcji oraz wartość tokenu transakcji odebrana z systemu PayPal poleceniem GET: tx=wartość_tokenu_transakcji 4. Należy wysłać token identyfikacyjny, używając zmiennej at oraz wartości tokenu identyfikacyjnego PDT użytkownika. at=token_identifykacyjny_użytkownika Aby uzyskać więcej informacji na temat tokenu identyfikacyjnego, zobacz Otrzymywanie tokenu identyfikacyjnego i korzystanie z niego na stronie 24. Odpowiedź PayPal na polecenie POST System PayPal odpowie na wysłane polecenie POST za pomocą pojedyńczego słowa w jednym wierszu, zawartego w treści odpowiedzi: SUCCESS or FAIL. Po otrzymaniu odpowiedzi pomyślnej, tj. SUCCESS, reszta treści odpowiedzi zawierać będzie szczegóły dotyczące transakcji, po jednym na wiersz, w formacie key=value, gdzie key i value to ciągi znaków kodowane w standardzie URL. Te dane odpowiedzi muszą zostać odpowiednio przetworzone i zdekodowane. Przykład odpowiedzi oznaczającej powodzenie: SUCCESS (powodzenie) first_name=jane+doe last_name=smith payment_status=completed 26 lipiec 2006

27 Przesłanie danych na temat płatności Zapobieganie oszustwom payer_ =janedoesmith%40hotmail.com payment_gross=3.99 mc_currency=usd custom=for+the+purchase+of+the+rare+book+green+eggs+%26+ham... Jeśli odpowiedź będzie informować o niepowodzeniu (FAIL), firma PayPal zaleca sprawdzenie, czy: token transakcji jest poprawny, token identyfikacyjny jest poprawny, tokeny nie straciły ważności. Funkcja PDT i automatyczny powrót: komunikaty do kupującego Przy korzystaniu z funkcji automatycznego powrotu użytkownik musi zawrzeć na stronie zwrotnego adresu URL informację, która informuje użytkownika o dokonaniu płatności, opomyślnym jej zakończeniu oraz o tym, że informacje dotyczące transakcji zostaną wysłane kupującemu w wiadomości . To od użytkownika zależy, ile i jakie szczegóły płatności zostaną wyświetlone klientowi; jednakże firma PayPal zaleca dołączenie następujących danych: Nazwa przedmiotu Zapłacona kwota Adres płatnika Adres wysyłkowy Jeżeli funkcja PDT jest używana do określenia, kiedy zamówienie ma zostać zrealizowane automatycznie, należy sprawdzić, czy wartość zmiennej payment_status to Completed, ponieważ kupujący mógł użyć metody, która nie powoduje natychmiastowego rozliczenia płatności, np. czeku elektronicznego. Aby zapoznać się z pełną listą zmiennych PDT, zobacz Załącznik A, Zmienne BPP i PDP. Zapobieganie oszustwom W celu zapobiegania oszustwom firma PayPal zaleca, aby programy użytkownika sprawdzały poniższe zmienne: txn_id nie powinna być duplikatem inaczej ktoś mógłby wykorzystać zmienną ze starszej, pomyślnie zakończonej transakcji. receiver_ powinna być adresem zarejestrowanym na koncie PayPal użytkownika weryfikacja tej zmiennej pozwala na upewnienie się, że płatność nie jest przesyłana na fałszywe konto. Sprawdź też inne szczegóły transakcji, takie jak numer elementu i cena, aby mieć pewność, że cena nie została zmieniona. lipiec

28 Przesłanie danych na temat płatności Przykłady kodu Przykłady kodu Firma PayPal udostępnia przykłady kodu, za pomocą których użytkownik może skonfigurować usługę PDT. Przykłady te znajdują się pod adresem Znajdują się tam przykłady kodu dla następujących środowisk programistycznych: ASP/VBScript ColdFusion PERL PHP 28 lipiec 2006

29 3 Błyskawiczne powiadamianie opłatności Błyskawiczne powiadamianie o płatności (BPP) umożliwia zintegrowanie płatności PayPal z operacjami przeprowadzanymi w witrynie internetowej użytkownika. Błyskawiczne powiadamianie o płatności umożliwia natychmiastowe powiadomienie i potwierdzenie otrzymanych płatności PayPal. W tym rozdziale szczegółowo opisano funkcję błyskawicznego powiadamiania o płatności wnastępujących rozdziałach: Konfigurowanie funkcji BPP Zatwierdzanie powiadomienia: zapobieganie oszustwom Korzystanie z wielowalutowych powiadomień BPP Proces błyskawicznego powiadamiania o płatności składa się z trzech części: 1. Klient wysyła płatność. 2. System PayPal wysyła (POST) zmienne FORM pod podany przez użytkownika adres URL, co uruchamia program przetwarzający zmienne. 3. Użytkownik zatwierdza powiadomienie. RYSUNEK 3.1 Jak działa BBP: trzy kroki podstawowe 1. Płatność ze strony klienta lub zwrot pieniędzy uruchamia funkcję błyskawicznego powiadamiania o płatności. Ta płatność może być realizowana za pomocą zmiennej FORM usługi Płatności za pośrednictwem witryny lub Usług sieciowych API w systemie PayPal dla ekspresowej realizacji transakcji, płatności zbiorczej lub zwrotu pieniędzy za lipiec

30 Błyskawiczne powiadamianie o płatności Konfigurowanie funkcji BPP transakcję. Jeśli płatność ma status Oczekująca, użytkownik otrzymuje kolejne powiadomienie BPP, gdy płatność zostanie rozliczona, nie zostanie zrealizowana lub zostanie odrzucona. 2. System PayPal wysyła zmienne FORM do programu dostępnego pod określonym adresem URL. Ten adres URL można określić na podkarcie Profil lub za pomocą zmiennej notify_url podczas realizacji każdej transakcji. Taki formularz POST stanowi podstawę funkcji BPP. W powiadomieniu są zawarte informacje o płatnościach klienta (takie jak imię i nazwisko klienta czy kwota płatności). Wszystkie możliwe zmienne zawarte w powiadomieniach BPP wyszczególniono w rozdziale Załącznik A, Zmienne BPP ipdp. Po otrzymaniu powiadomienia serwer musi przetworzyć przychodzące dane. 3. Serwer musi zweryfikować powiadomienie, aby upewnić się, że jest prawidłowe. Aby uzyskać szczegółowe informacje, zobacz Załącznik A, Zmienne BPP i PDP. Konfigurowanie funkcji BPP Proces konfigurowania funkcji BPP składa się z dwóch części: 1. uaktywnienia funkcji BPP dla konta PayPal użytkownika, 2. konfigurowania programu w celu przetwarzania zmiennych FORM BPP w witrynie użytkownika. Uaktywnienie funkcji BPP Aby uaktywnić funkcję BPP, można zmienić ustawienie na karcie Profil w systemie PayPal lub uwzględnić zmienną notify_url w zmiennej FORM płatności we własnej witrynie. Określanie ustawień na karcie Profil 1. Zaloguj się do konta PayPal (konto specjalne lub firmowe). 2. Kliknij podkartę Profil. 3. W kolumnie Preferencje dotyczące sprzedaży kliknij łącze Błyskawiczne powiadamianie o płatności preferencje. 4. Kliknij przycisk Edytuj. 5. Zaznacz pole wyboru i wprowadź adres URL programu, który ma przetwarzać powiadomienia BPP. 6. Kliknij przycisk Zapisz. 30 lipiec 2006

31 Błyskawiczne powiadamianie o płatności Zatwierdzanie powiadomienia: zapobieganie oszustwom notify_url Funkcję BPP można uaktywnić, dodając zmienną notify_url do kodu HTML przycisku PayPal. Pole to określa adres URL programu, który może przetwarzać powiadomienia BPP. Aby uzyskać więcej informacji, zobacz Zatwierdzanie powiadomienia: zapobieganie oszustwom na stronie 31. Konfigurowanie programu przetwarzającego powiadomienia BPP Dane wysłane do użytkownika przez funkcję BPP mają postać zmiennych FORM w kodzie HTML zawierającego pary nazwa/wartość. Używany program musi przetwarzać przynajmniej takie pary. To, jakie inne przetwarzanie może być wymagane, zależy od potrzeb związanych z zarządzaniem zamówieniami, od rodzaju używanych baz danych oraz od innych czynników, które wykraczają poza zakres tego podręcznika. Przykłady kodów dla następujących środowisk programistycznych są dostępne w witrynie PayPal pod adresem ASP.Net/C# ASP/VBScript ColdFusion Java/JSP Perl PHP Zatwierdzanie powiadomienia: zapobieganie oszustwom Gdy serwer użytkownika otrzyma powiadomienie BPP, należy potwierdzić jego odebranie. Nazywa się to zatwierdzaniem powiadomienia i jest metodą stosowaną przez firmę PayPal w celu zapobieżenia atakom typu spoofing czy man in the middle. WAŻNE: Jeśli użytkownik nie używa zaszyfrowanych płatności za pośrednictwem witryny lub weryfikacji opartej na współdzieleniu poufnej informacji, musi sprawdzić cenę, numer identyfikacyjny transakcji, adres odbiorcy PayPal oraz inne dane przesłane w powiadomieniu BPP, aby mieć pewność, że są poprawne. Sprawdzając te dane, zyska gwarancję, że nie jest to atak typu spoofing. Są dwa sposoby zatwierdzania powiadomienia: 1. Wysyłanie poufnej informacji współdzielonej, którą zna tylko użytkownik, opisano w rozdziale Weryfikacja oparta na współdzieleniu poufnej informacji na stronie 33. Firma PayPal zaleca tę metodę, ponieważ gwarantuje ona prawidłowość danych i zmniejsza ruch w sieci przychodzący i wychodzący z witryny użytkownika. Weryfikacja oparta na współdzieleniu poufnej informacji jest odpowiednia: jeśli użytkownik nie korzysta ze współdzielonej usługi hostingu witryny, lipiec

32 Błyskawiczne powiadamianie o płatności Zatwierdzanie powiadomienia: zapobieganie oszustwom jeśli użytkownik ma włączoną obsługę protokołu SSL na swoim serwerze sieciowym, jeśli użytkownik korzysta z zaszyfrowanych płatności za pośrednictwem witryny PayPal, jeśli użytkownik stosuje zmienną notify_url w każdej transakcji płatności. 2. Wysyłanie formularza POST z powrotem do systemu PayPal po otrzymaniu powiadomienia BPP i zweryfikowaniu poprawności danych opisano w rozdziale Formularz zwrotny HTTPS wysyłany do systemu PayPal na stronie 33. Formularz zwrotny jest odpowiedni: jeśli użytkownik korzysta ze współdzielonej usługi hostingu witryny, jeśli użytkownik nie ma włączonej obsługi protokołu SSL. Obie metody są oparte na powiadomieniach URL, które są opisane w następnym rozdziale. Poufna informacja współdzielona przypadająca na transakcję lub ustawienie na podkarcie Profil Adres URL, pod który system PayPal wysyła dane BPP, jest nazywany adresem URL powiadomienia. Może być albo ustawiony dla poszczególnych transakcji płatności lub globalnie na podkarcie Profil dla wszystkich transakcji: Na jedną transakcję: Aby otrzymywać powiadomienia o płatności dla różnych płatności na różne adresy URL (np. jeśli użytkownik potrzebuje oddzielnych płatności dla różnych swoich witryn), należy użyć zmiennej notify_url w celu przekazania adresu URL powiadomienia. Przy każdej płatności system PayPal zapisuje wartość zmiennej notify_url dla określonej płatności i wszelkie kolejne aktualizacje tej płatności (np. rozliczenie czeku elektronicznego) są wysyłane na adres określony przez zmienną notify_url. Kiedy zmienna notify_url jest przekazywana w formularzu POST, zastępuje ustawienie na podkarcie Profil. UWAGA: Wartość zmiennej notify_url musi być zaszyfrowanym adresem URL. Ustawienie na podkarcie Profil: Aby otrzymywać wiadomości BPP tylko na jeden adres URL, należy wprowadzić ten adres w sekcji Preferencje na podkarcie Profil. Podobnie poufną informację współdzieloną używaną do potwierdzenia otrzymania powiadomienia BPP można ustawić albo dla poszczególnych transakcji, albo globalnie na podkarcie Profil dla wszystkich transakcji. Na jedną transakcję: Aby odróżnić poufną informację współdzieloną dla każdego powiadomienia o każdej płatności, należy dołączyć nazwę zmiennej FORM iwartość poufnej informacji współdzielonej do wartości zmiennej notify_url. Kiedy poufna informacja współdzielona jest przekazywana w formularzu POST płatności, zastępuje ustawienie na podkarcie Profil. Ustawienie na podkarcie Profil: Aby do każdej transakcji przypisać tę samą poufną informację współdzieloną, należy wprowadzić tę poufną informację w rozdziale Preferencje podkarty Profil. 32 lipiec 2006

33 Błyskawiczne powiadamianie o płatności Zatwierdzanie powiadomienia: zapobieganie oszustwom Weryfikacja oparta na współdzieleniu poufnej informacji Zalecaną metodą zatwierdzania powiadomień jest użycie poufnej informacji współdzielonej dla poszczególnych transakcji płatności. Należy dodać zmienną poufnej informacji współdzielonej i jej wartość do wartości zmiennej notify_url adresu URL, na który są wysyłane dane BPP po dokonaniu płatności. Poufna informacja składa się z następujących elementów: notify_url=youripnnotificationurl?shared_secret_variable_name=shared_secret_value gdzie: youripnnotificationurl to adres URL w witrynie użytkownika, na który mają przychodzić powiadomienia. shared_secret_variable_name to dowolna nazwa zmiennej. shared_secret_value to sama poufna informacja. Wartość zmiennej notify_url może na przykład wyglądać tak: notify_url=https%3a// Bezpieczeństwo weryfikacji opartej na poufnej informacji współdzielonej Aby zapewnić bezpieczeństwo poufnej informacji współdzielonej, należy użyć zaszyfrowanych płatności za pośrednictwem witryny. Informacje o zaszyfrowanych płatnościach za pośrednictwem witryny można znaleźć w dokumencie Realizacja płatności za pośrednictwem witryny PayPal podręcznik integracji. Wartość poufnej informacji współdzielonej nie jest zaszyfrowana to czytelny tekst, co ułatwia proces przetwarzania. Z tego względu wartość poufnej informacji współdzielonej jest zapisywana w rejestrze dostępu serwera. Należy stosować odpowiednie zabezpieczenia rejestrów dostępu serwera. Jeśli użytkownik korzysta z usługi hostingu serwera sieciowego, powinien upewnić się, że dostawca usługi stosuje odpowiednie metody zabezpieczania danych. WAŻNE: Adres URL powiadomienia powinien sprawdzać ważność zwróconej informacji poufnej i oznaczać do przebadania wszelkie transakcje, do których nie jest dołączona poprawna informacja poufna. Formularz zwrotny HTTPS wysyłany do systemu PayPal Druga metoda zatwierdzania powiadomienia BPP to zwrócenie do systemu PayPal dokładnych zmiennych i wartości otrzymanych w powiadomieniu BPP. Tworzenie formularza POST Oto wskazówki dotyczące tworzenia formularza HTTPS POST BPP wysyłanego do systemu PayPal w celu zatwierdzenia powiadomienia. UWAGA: Można zaimplementować BPP bez protokołu SSL, ale firma PayPal nie zaleca tego rozwiązania. lipiec

34 Błyskawiczne powiadamianie o płatności Korzystanie z wielowalutowych powiadomień BPP 1. Formularz POST musi zostać wysłany na adres 2. Należy uwzględnić w niej zmienną cmd i wartość _notify-validate: cmd=_notify-validate 3. Należy wysłać wszystkie otrzymane zmienne formularza w dokładnie takiej samej postaci, w jakiej zostały odebrane. Odpowiedź systemu PayPal na formularz zwrotny System PayPal odpowiada na formularz zwrotny za pomocą jednego słowa w treści odpowiedzi: VERIFIED lub INVALID. Po otrzymaniu odpowiedzi VERIFIED należy wykonać następujące czynności kontrolne: 1. Sprawdź, czy zmienna payment_status ma wartość Completed. 2. Jeśli zmienna payment_status ma wartość Completed, sprawdź zmienną txn_id w odniesieniu do poprzednio przetworzonej transakcji PayPal, aby upewnić się, że to nie jest duplikat. 3. Po sprawdzeniu zmiennych payment_status i txn_id upewnij się, że zmienna receiver_ to adres zarejestrowany dla konta PayPal. 4. Sprawdź, czy cena (mc_gross) i waluta (mc_currency) są prawidłowe dla danego przedmiotu, oraz zmienne item_name i item_number. 5. Sprawdź, czy zwrócona poufna informacja współdzielona jest prawidłowa. Po wykonaniu powyższych czynności kontrolnych można zaktualizować bazę danych na podstawie otrzymanych informacji. Jeśli odebrana odpowiedź będzie miała wartość INVALID, należy przeprowadzić dochodzenie. W niektórych przypadkach taka odpowiedź może być spowodowana błędem BPP, być może zmianą formatu BPP. Aby określić, czy jest to błąd BPP, najpierw sprawdź kod. Aby uzyskać dodatkową pomoc, przejdź do strony kliknij temat Narzędzia handlowców, a następnie Błyskawiczne powiadamianie o płatności. Korzystanie z wielowalutowych powiadomień BPP Dzięki powiadomieniom wielowalutowym można akceptować płatności w dowolnej walucie obsługiwanej przez system PayPal (zobacz Waluty obsługiwane w systemie PayPal, kody walut oraz maksymalne kwoty transakcji na stronie 17). Powiadomienia BPP będą wówczas zawierały informacje o walucie płatności. Poniższy opis wyjaśnia, w jaki sposób funkcja BPP obsługuje różne waluty. UWAGA: Jeśli użytkownik korzysta z rozwiązań PayPal Płatności za pośrednictwem witryny (np. z koszyka) i chce otrzymywać płatności w walucie innej niż dolar amerykański, musi skonfigurować przyciski dla wybranej waluty. 34 lipiec 2006

35 Błyskawiczne powiadamianie o płatności Korzystanie z wielowalutowych powiadomień BPP Zmienne payment_gross i payment_fee Te zmienne reprezentują otrzymaną kwotę oraz odpowiadającą jej opłatę w dolarach amerykańskich (USD). Jeśli otrzymana kwota i naliczona opłata są w walucie innej niż USD, zmienne pojawią się w powiadomieniu BPP, ale nie będą zawierały wartości. UWAGA: Zmienna payment_fee nie zawsze występuje w powiadomieniach BPP, np. w przypadku płatności oczekujących. Te wartości nie występują w płatnościach w walucie innej niż USD, tak więc skrypty BPP nie przetworzą tych kwot w USD. Jednak poprzednie skrypty będą nadal działały, o ile handlowiec będzie otrzymywał tylko płatności w USD. Przykłady wielowalutowych zmiennych BPP Powiadomienia BPP, w których używana jest zmienna payment_gross, będą zawierały także następujące zmienne wielowalutowe. Zmienne mc_gross i mc_fee nie zostaną dodane do powiadmień BPP zawierających zmienną txn_type: subscr_signup, subscr_cancel, subscr_modify, subscr_failed lub subscr_eot. mc_gross: Otrzymano pełną kwotę płatności bez naliczania opłaty za transakcję. UWAGA: Jeśli płatność jest w USD, wartość zmiennej payment_gross jest równa wartości zmiennej mc_gross. mc_fee: Opłata za transakcję z tytułu realizacji płatności. Zmienna ta działa jak zmienna payment_fee (zmienna ta nie występuje w przypadku płatności oczekujących itd.). UWAGA: Jeśli płatność jest w USD, wartość zmiennej payment_fee jest równa wartości zmiennej mc_fee. mc_currency: Waluta kwot zmiennych mc_gross, mc_fee, payment_gross i payment_fee. Możliwe wartości wyszczególniono w części Waluty obsługiwane w systemie PayPal, kody walut oraz maksymalne kwoty transakcji na stronie 17. W przypadku subskrypcyjnych BPP dotyczących zapisywania się, anulowania, niepowodzenia czy EOT (końca transmisji) zmienna mc_currency to zazwyczaj waluta subskrypcji, a nie waluta płatności. Przykład 1 Jeśli użytkownik ma saldo w USD i otrzyma płatność w kwocie 100 USD, dla tej płatności zostaną użyte następujące zmienne: mc_gross = payment_gross mc_fee = payment_fee PRZYKŁAD 3.1 Wielowalutowe powiadomienie BPP: płatność w dolarach amerykańskich payment_status = Completed payment_gross = 100 payment_fee = 3.00 mc_gross = 100 mc_fee = 3.00 mc_currency = USD lipiec

36 Błyskawiczne powiadamianie o płatności Korzystanie z wielowalutowych powiadomień BPP Przykład 2 Jeśli użytkownik ma saldo w dolarach kanadyjskich i otrzyma płatność w kwocie 100 CAD, dla tej płatności zostaną użyte następujące zmienne: mc_gross i mc_fee będą miały wartości, payment_gross i payment_fee będą puste. PRZYKŁAD 3.2 Wielowalutowe powiadomienie BPP: płatność w dolarach kanadyjskich payment_status = Completed payment_gross = payment_fee = mc_gross = 100 mc_fee = 3.00 mc_currency = CAD Przykład 3 Jeśli dla konta ustawiono automatyczne przeliczanie płatności, te zmienne zostaną użyte do przedstawienia przeliczenia. Ten przykład dotyczy użytkownika z saldem w USD, który otrzymał płatność w kwocie 100 GBP: PRZYKŁAD 3.3 Wielowalutowe powiadomienie BPP: automatyczne przeliczenie płatności w funtach brytyjskich payment_status = Completed payment_gross = payment_fee = mc_gross = 100 mc_fee = 3.00 mc_currency = GBP settle_amount = settle_currency = USD exchange_rate = 1.5 Przykład 4 Jeśli otrzymana płatność jest oczekująca zgodnie ze zmienną pending_reason = multi_currency, pierwsze otrzymane powiadomienie BPP nie będzie zawierało zmiennych settle_amount, settle_currency ani exchange_rate. PRZYKŁAD 3.4 Wielowalutowe powiadomienie BPP: płatność oczekująca payment_status = Pending pending_reason = multi_currency payment_gross = mc_gross = 100 mc_currency = GBP 36 lipiec 2006

37 Błyskawiczne powiadamianie o płatności Powiadomienie o sporze W drugim powiadomieniu BPP będą zawarte informacje o rozliczeniu płatności. Jeśli płatność zostanie przyjęta w podstawowej walucie konta, którą w poniższym przykładzie jest USD: PRZYKŁAD 3.5 Oczekująca przelicz na walutę podstawową payment_status = Completed payment_gross = payment_fee = mc_gross = 100 mc_fee = 3.00 mc_currency = GBP settle_amount = settle_currency = USD exchange_rate = 1.5 Jeśli płatność jest przyjmowana na saldo w tej samej walucie: PRZYKŁAD 3.6 Oczekująca przyjmij na saldo walutowe payment_status = Completed payment_gross = payment_fee = mc_gross = 100 mc_fee = 3.00 mc_currency = GBP Jeżeli płatność jest odrzucona: PRZYKŁAD 3.7 Oczekująca odrzucona payment_status = Denied payment_gross = mc_gross = 100 mc_currency = GBP UWAGA: Jeśli użytkownik otrzymuje płatność na saldo walutowe i później przelicza otrzymaną kwotę na inną walutę, transakcji przeliczenia waluty nie będzie towarzyszyło powiadomienie BPP. Powiadomienie o sporze Kupujący mogą rejestrować roszczenia dotyczące płatności. Takie roszczenia są nazywane sprawami. Firma PayPal powiadamia handlowców o nowych sprawach za pomocą poczty i powiadomień BPP. Są dwa rodzaje spraw: Reklamacja: kupujący zarejestrował roszczenie dotyczące płatności na rzecz handlowca za pośrednictwem Centrum rozstrzygania sporów PayPal. UWAGA: Po otrzymaniu powiadomienia reklamacji handlowcy muszą zalogować się do systemu PayPal, aby za pośrednictwem Centrum rozstrzygania sporów ustosunkować się do sprawy. lipiec

38 Błyskawiczne powiadamianie o płatności Powiadomienie o sporze Obciążenie zwrotne: kupujący zgłosił u wystawcy karty kredytowej reklamację, której skutkiem było obciążenie zwrotne. Wystawca karty kredytowej powiadamia firmę PayPal o przyczynie obciążenia zwrotnego. Po przeanalizowaniu sprawy firma PayPal powiadamia handlowca o wymaganych działaniach. Zmienne BPP dotyczące spraw obejmują typ sprawy, przyczynę i inne informacje związane ze sprawą. Aby uzyskać informacje o wszystkich zmiennych i ich możliwych wartościach, zobacz Zmienne powiadomienia o sporze na stronie lipiec 2006

39 4 Historia transakcji i narzędzia raportowania Dzięki historii transakcji oraz narzędziom raportowania możesz mieć dostęp do miesięcznych wyciągów z rachunku, wyszukiwać określone zakresy dat w celu znalezienia poszczególnych transakcji lub sporów z klientami oraz pobierać wyniki wyszukiwania do komputera. Aby uzyskać dostęp do tych funkcji: 1. Zaloguj się do konta specjalnego lub firmowego w systemie PayPal. 2. Kliknij podkartę Historia. Stronę Historia przedstawia Rysunek 4.1, Strona Historia. RYSUNEK 4.1 Strona Historia Miesięczne wyciągi z rachunku Po uaktywnieniu tej funkcji użytkownik będzie mógł przeglądać miesięczne wyciągi z rachunku dotyczące historii transakcji. Nowe wyciągi są przygotowywane 15 dnia każdego miesiąca i przechowywane w trybie online maksymalnie przez trzy miesiące. lipiec

40 Historia transakcji i narzędzia raportowania Przeszukiwanie historii w trybie online Aby uaktywnić miesięczne wyciągi z rachunku: 1. Kliknij Wyświetl na stronie Historia. 2. Na wyświetlonej stronie kliknij przycisk radiowy Tak. 3. Kliknij przycisk Zapisz. Przeszukiwanie historii w trybie online Strona Historia daje użytkownikowi wiele możliwości wyszukiwania pozycji w historii transakcji w trybie online. Istnieją dwa rodzaje wyszukiwania: podstawowe i zaawansowane. Przy wyszukiwaniu podstawowym użytkownik określa zakres dat oraz szukany rodzaj działania. Przy wyszukiwaniu zaawansowanym użytkownik określa zakres dat oraz szukany wzór wokreślonych polach historii transakcji. Wyszukiwanie podstawowe: okresy czasowe Wyniki wyszukiwania można zawęzić na dwa sposoby. 1. Użytkownik może wybrać gotowe zakresy dat: Poprzedni dzień Poprzedni tydzień Poprzedni miesiąc Poprzedni rok 2. Użytkownik może wybrać dokładny zakres dat; dzień, miesiąc oraz rok w polach Od oraz Do. WAŻNE: Szybkość otrzymania wyniku zależy od wielkości wybranego zakresu dat. Im większy zakres, tym więcej czasu zajmie wyszukiwanie. Aby otrzymać wyniki jak najszybciej, zalecamy korzystanie z jak najmniejszych zakresów dat. 40 lipiec 2006