Korzystając z kilku funkcji Firebase i Stripe, możesz przetwarzać płatności w swojej aplikacji internetowej bez tworzenia własnej infrastruktury serwera. W tym przewodniku znajdziesz instrukcje dostosowywania i wdrażania własnej wersji przykładowej aplikacji open source cloud-functions-stripe-sample.web.app.
Zanim zaczniesz, utwórz projekt w konsoli Firebase i skonfiguruj konto Stripe.
Omówienie wdrażania
- Skonfiguruj konto Stripe.
- Utwórz projekt w konsoli Firebase.
- Przejdź w projekcie na abonament Blaze rozliczany według wykorzystania.
- Skonfiguruj interfejs wiersza poleceń Firebase do korzystania z Twojego projektu w usłudze
firebase use --add
. - Pobierz kod źródłowy przykładowej aplikacji Firestripe. Skonfiguruj go, podając odpowiednie informacje o projekcie, i dostosuj kod do swojej aplikacji.
- Po wdrożenie aplikacji w konsoli Firebase znajdziesz listę użytkowników i transakcji.
Konfigurowanie i wdrażanie przykładowej aplikacji
- Pobierz kod źródłowy.
- Włącz logowanie przez Google i e-mail w ustawieniach dostawcy uwierzytelniania.
- Włącz Cloud Firestore.
- Zainstaluj wiersz poleceń Firebase, jeśli jeszcze tego nie zrobiono, i zaloguj się za pomocą
firebase login
. - Skonfiguruj ten szablon tak, aby używał Twojego projektu w kontekście
firebase use --add
. - Zainstaluj zależności lokalnie, uruchamiając
cd functions; npm install; cd -
Dodaj klucz tajny interfejsu Stripe API do konfiguracji środowiska Cloud Functions:
firebase functions:config:set stripe.secret=<YOUR STRIPE SECRET KEY>
Ustaw klucz publikowania w usłudze Stripe w sekcji
/public/javascript/app.js
:const STRIPE_PUBLISHABLE_KEY=<YOUR STRIPE PUBLISHABLE KEY>;
Wdróż projekt za pomocą
firebase deploy
. To polecenie:- Wysyła wszystkie pliki z katalogu
public
do Hosting, aby Twoja witryna była dostępna. - Wysyła kod z katalogu
functions
do Cloud Functions for Firebase. - Ustawia reguły zabezpieczeń w bazie danych Cloud Firestore zgodnie z konfiguracją w
firestore.rules
. Podane reguły umożliwiają użytkownikowi tylko odczytywanie i zapisywanie własnych płatności i form płatności.
- Wysyła wszystkie pliki z katalogu
Testowanie przykładowej aplikacji
Otwórz adres URL swojej aplikacji do płatności na stronie your-firebase-project-id.web.app
i sprawdź, czy działają te funkcje:
- Możesz zalogować się za pomocą Google lub e-maila.
- Możesz dodać nową kartę testową Stripe i wyświetlić ją w elemencie wyboru karty.
- Możesz wybrać jedną z kart i na niej naliczyć opłatę.
- Możesz się wylogować.
Dla porównania możesz skorzystać z funkcji cloud-functions-stripe-sample.web.app.
Aby zapewnić użytkownikom wygodę, możesz dostosować wygląd strony płatności lub dodać ją do istniejącej aplikacji.
Wyświetlanie przetworzonych płatności
Po skonfigurowaniu i wdrożeniu strony płatności możesz w konsoli Firebase sprawdzić listę użytkowników wraz z ich formami płatności i płatnościami.
- Otwórz stronę Cloud Firestore.
- Sprawdź listę użytkowników i jeśli dodali oni jakieś karty kredytowe lub dokonali transakcji, sprawdź listę tych kart i transakcji.
Akceptowanie płatności na żywo
Gdy wszystko będzie gotowe do wdrożenia, musisz wymienić klucze testowe na klucze produkcyjne. Więcej informacji o tych kluczach znajdziesz w dokumentacji Stripe.
Zaktualizuj konfigurację obiektu tajnego Stripe:
firebase functions:config:set stripe.secret=<YOUR STRIPE LIVE SECRET KEY>
W sekcji
/public/javascript/app.js
ustaw klucz umożliwiający publikację na żywo.Aby zmiany zaczęły obowiązywać, ponownie wdrożyć zarówno Cloud Functions, jak i Hosting:
firebase deploy
.