Tutorial: Paypal we Flash ze SWiSH Max
Za pomocą niewielkiej ilości skryptu, jest możliwe dodanie płatności PayPal do twojej witryny www za pomocą obiektu Flash LoadVars.
Chociaż pokrótce opisany w naszym pliku pomocy, szczegółowy opis klasy LoadVars można znalźć na Adobe website lub Flash AS2 language reference pdf, który może być pobrany z tego linku.
By utworzyć twój własny sklep musisz mieć konto Paypal. Konto Premier lub Business jest wymagane, Jeśli chcesz włączyć cechę PayPal. Cecha PayPal Guest pozwala użytkownikom nie mającym konta na PayPal tworzyć płatności z kartą kredytową. Osobiście myślę, że funkcja ta jest niezbędna, jeżeli chcesz by przy PayPal do obsługi wszystkich transakcji.
Obecnie nie ma kosztów założenia konta PayPal, jakkolwiek konto Business wymaga dodatkowych dokumentów (dowodu własności, dokumentów rejestracyjnych itp.).
PayPal pobiera ryczałtowa opłatę + procent każdej transakcji. Proszę obejrzeć stronę PayPal po więcej informacji.
Poniższy przykład został kodowany w celu uproszczenia, skryptów i wykazać główne pojęcia.
Krok 1: Dodaj przycisk
Dodaj przycisk do twoje strony. By zademonstrować użyłem jednego z przycisków komponentów SWiSH Max, Przycisk | Pushbutton | Przycisk. Wybierz przycisk z panelu komponenty i przeciągnij go na pulpit Maxa.
Panel Konspekt (ang. Outline) powinien być jak obrazek po lewej.
w panelu parametry przycisku, ustaw parametr Label Płać.
Krok 2: Dodaj skrypt
Skopiuj do głównego filmu poniższy skrypt:
function Events(n,v) {
var postvars = new LoadVars();
postvars.cmd = "_cart";
postvars.business = "mybusiness@adomain.com"; // konto paypal lub email
postvars.upload = "1"; // definiuje koszyk użytkownika
postvars.currency_code = "PLN"; // domyślnie USD gdy opuszczone
// użyj shipping_1 jako całkowita kwota dostawy dla wszystkie przedmiotów.
// alternatywnie możesz użyć inwidualnych kwot dostawy dla każdego przedmiotu.
postvars.shipping_1 = "0.50";
// dane pierwszego przedmiotu w koszyku. Zauważ każda zmienna var kończy się z _1
postvars.item_name_1 = "item 1"; // nazwa przedmiotu
postvars.item_number_1 = "1234"; // numer przedmiotu
postvars.amount_1 = "$0.10"; // cena przedmiotu
postvars.quantity_1 = "2"; // ilość, domyślnie 1, gdy opuszczona.
// dane pierwszego przedmiotu w koszyku. Zauważ każda zmienna var kończy się z _2
postvars.item_name_2 = "item 2";
postvars.item_number_2 = "12345";
postvars.amount_2 = "$0.50";
postvars.on0_2 = "XL"; // opcja 1 (opcjonalnie) wysyłana w opisie przedmiotu.
postvars.on1_2 = "Red"; // opcja 2.
postvars.send("https://www.paypal.com/cgi-bin/webscr", "_blank", "POST");
}
Wszystkie przyciski komponentów wołają zdefiniowaną przez użytkownika funkcję w nadrzędnym obiekcie. Zakładamy że funkcja ma mieć 2 parametry, n i v. n określające nazwę wołającego obiektu (np. nazwę przycisku) i stan v przycisku. v jest zawsze true dopóki nie przełączy się stanu przycisku w parametrach przycisku.
Powyższy skrypt zakłada, że tylko jeden obiekt woła funkcję Events . W związku z tym, zmienna n nie jest sprawdzana .Jeśli wiele obiektów wywoła tę samą funkcję zdarzenia wówczas należy użyć instrukcji switch(), aby przetwarzać różne akcje dla różnych obiektów.
Opis
Obiekt LoadVars jest tworzony i i zmienne html są przypisywane w nawiażaniu do zmiennych PayPal html . Wszystkie dostępne zmienne html są opisane na tej stronie PayPal.
Zmienne użyte w tym przykładzie są opisane w poniższej tabelce:
| htmlVar (zmienna html) |
Wartość | Komentarz |
| cmd | _cart | Wskazuje, że wózek jest używany (w przeciwieństwie do pojedynczych elementów). |
| business | adres e-mail paypal lub business ID. | Określa, dla kogo dokonać płatności. Jeśli używany adres e-mail: wybierz adres z nazwą firmy przed małpką mojafirma@domena.pl. Spowoduje to, że transakcje są wyświetlane jako: PAYPAL * MOJAFIRMA w sprawozdaniach karty kredytowej nabywcy. |
| upload | 1 | Wskazuje, że koszyka użytkownika jest w użyciu. |
| currency_code | USD, PLN, itp. | Opcjonalnie. Wskazuje typ waluty w użyciu. Jeśli pominięto, używane jest USD. |
| Następujące elementy stosuje się do pojedynczych elementów w koszyku. Pierwszy element w koszyku ma _1 na początku każdej nazwy, 2-gi element ma _2 itp. Nie może być przerwy w sekwencji numerów. np. nie może być _1 i _3 bez elementu _2. | ||
| item_name | Nazwa elementu. | |
| item_number | Opcjonalne. Numer katalogowy elementu. | |
| amount | $N.NN | Cena pojedynczego elementu. |
| quantity | N | Opcjonalne. W przypadku pominięcia, zakłada się 1.Musi być liczbą >= 1. 0 i wartości ujemne są niedozwolone. |
| on0 | opcja 1 | Opcjonalne. Wybierana przez użytkownika opcja, jak rozmiar lub kolor. Informacja o opcji jest wysyłana z zamówieniem i potwierdzeniem e-mailem. |
| on1 | opcja 2 | Opcjonalne. Wybierana przez użytkownika opcja, jak rozmiar lub kolor. Informacja o opcji jest wysyłana z zamówieniem i potwierdzeniem e-mailem. |
| shipping | Dostawa. Gdy używane z koszykiem, polecam użycie shipping_1 do określania całkowitej dostawy dla wszystkich elementów. Jest jednak możliwe określenie indywidualnych kwot dostawy dla każdego elementu w koszyku. Te są sumowane przez PayPal do postaci całkowitego kosztu dostawy. Należy zauważyć, że shipping (w przeciwieństwie do shipping_1) nie wydaje się działać jako sposób definiowania kwoty dostawy dla całego koszyka. |
Po przypisaniu zmiennych, polecenie LoadVars.send jest używane by otworzyć stronę, która umożliwia przetworzenie transakcji.
postvars.send("https://www.paypal.com/cgi-bin/webscr", "_blank", "POST");
Po pomyślnym zakończeniu płatności, użytkownikowi pokazuje się strona podobna do poniższej. Ze względów prywatności, rzeczywiste dane transakcji zostały zastąpiony tekstem fikcyjnym (pokazane na pomarańczowo).
Szczegóły transakcji są wysyłane e-mailem przez Paypal do kupującego i do odbiory płatności określonego przez konto w Paypal.
Testowanie
Polecenie LoadVars .send nie działa, jeśli film jest przeglądany w wewnętrznym odtwarzaczu za pomocą przycisku Odtwórz. Następuje to z uwagi na ustawienia zabezpieczeń cross domain.
Aby przetestować proces zakupu, użyj Plik | Test | SWF we flash player lub Plik | Test | HTML + SWF w przeglądarce po ustawieniu globalnych ustawień Flash playera by potraktować folder eksportu jako zaufaną lokację.
By ustawić folder eksportu jako zaufana lokacja, kliknij prawym klawiszem myszy na filmie Flash podczas odtwarzania. Wybierz Ustawienia Globalne | Zaawansowane | Ustawienia lokalizacji zaufanych i następnie kliknij przycisk Dodaj… by dodać swój folder eksportu.
Sekwencja jest pokaza na obrazkach niżej:
Pobieranie
Przykładowy film może być pobrany z linku.
Przed użyciem, zmień linię w skypcie…
postvars.business = "mybusiness@adomain.com"; // konto paypal lub email
…Aby odzwierciedlić rzeczywistą informację o koncie Paypal. Jako że adres e-mail, użyty w filmie do próbki jest fikcyjny, opcje płatności PayPal gościa nie są oferowane. Proszę nie płacić pieniędzy na konto to fikcyjne.
Dostosowanie
Instrument płatności PayPal zapewnia znacznie więcej opcji niż wyjaśnione w tym blogu. Ten wpis ma służyć jako wstęp do używania.Zajrzyj do dokumentacji referencyjnej PayPal po opis wszystkich dostępnych opcji.