API dla programistów
Zintegruj się z Schematy URL
Uruchom usługę Payment for Stripe w swojej aplikacji lub witrynie, aby przetwarzać transakcje. Przekaż dane klientów, kwoty i informacje o produktach, a następnie obsłuż oddzwonienie po zakończeniu transakcji.
Jak to działa
Twoja aplikacja otwiera zapłata:// Adres URL z parametrami
Płatność za Stripe uruchamia i przetwarza transakcję
Po zakończeniu aplikacja przekieruje Cię do adresu URL wywołania zwrotnego z wynikiem
Punkty końcowe
Utwórz opłatę
payment://new?Przetwórz jednorazową płatność podając kwotę, walutę i opis.
Parametry
| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
amount | integer | Tak | Kwota w centach (np. 1000 = 10,00 USD) |
currency | string | NIE | Trzyliterowy kod waluty ISO (domyślnie: USD) |
description | string | NIE | Opis opłaty zakodowany w adresie URL |
customer | string | NIE | Istniejący identyfikator klienta Stripe |
email | string | NIE | E-mail klienta z potwierdzeniem odbioru |
name | string | NIE | Nazwa klienta zakodowana w adresie URL |
metadata | string | NIE | Niestandardowe pary klucz-wartość (JSON zakodowany w adresie URL) |
callback | string | NIE | Adres URL, do którego należy powrócić po zakończeniu |
autoprocess | boolean | NIE | Pomiń ekran główny i od razu rozpocznij ładowanie |
Utwórz fakturę
payment://cart?Utwórz fakturę Stripe zawierającą pozycje z katalogu produktów.
Parametry
| Nazwa | Typ | Wymagany | Opis |
|---|---|---|---|
prices | string | Tak | Identyfikatory cen rozdzielone przecinkami wraz z ilościami (np. price_abc:2,price_xyz:1) |
customer | string | NIE | Istniejący identyfikator klienta Stripe |
email | string | NIE | E-mail klienta z potwierdzeniem odbioru |
name | string | NIE | Nazwa klienta zakodowana w adresie URL |
callback | string | NIE | Adres URL, do którego należy powrócić po zakończeniu |
Obsługa wywołań zwrotnych
Po zakończeniu transakcji usługa Payment for Stripe przekieruje Cię do adresu URL wywołania zwrotnego z parametrami zapytania wskazującymi wynik.
Parametry wywołania zwrotnego
| Parametr | Wartości | Opis |
|---|---|---|
status | success | error | cancelled | Wynik transakcji |
charge_id | string | Identyfikator opłaty Stripe (w przypadku powodzenia) |
error | string | Komunikat o błędzie (w przypadku błędu) |
Przykłady
Proste ładowanie
Pobierz 10,00 USD za pomocą określonej kwoty
payment://new?amount=1000Opłata z opisem
Opłata 25,00 € z opisem
payment://new?amount=2500¤cy=eur&description=Coffee%20and%20pastryOpłata za nowego klienta
Pobierz 50,00 USD i utwórz rekord klienta
payment://new?amount=5000&name=John%20Smith&[email protected]Obciąż istniejącego klienta
Obciąż istniejącego klienta Stripe kwotą 75,00 USD
payment://new?amount=7500&customer=cus_ABC123xyzOpłata za pomocą metadanych
Pobierz opłatę w wysokości 100,00 USD wraz z niestandardowymi metadanymi dla Twoich rekordów
payment://new?amount=10000&description=Invoice%20%231234&metadata=%7B%22order_id%22%3A%221234%22%2C%22location%22%3A%22Store%20A%22%7DAutomatyczne przetwarzanie z wywołaniem zwrotnym
Pomiń ekran główny i wróć do aplikacji po zakończeniu
payment://new?amount=3500&autoprocess=true&callback=myapp://payment-completeFaktura z pozycjami wierszowymi
Utwórz fakturę z produktami z katalogu Stripe
payment://cart?prices=price_coffee:2,price_muffin:1&[email protected]Pełny przykład
Wszystkie parametry połączone w celu uzyskania w pełni zintegrowanego przepływu
payment://new?amount=15000¤cy=usd&description=Service%20Fee&customer=cus_ABC123xyz&metadata=%7B%22invoice%22%3A%22INV-2024-001%22%7D&autoprocess=true&callback=myapp://payment-resultKodowanie adresu URL
Pamiętaj o zakodowaniu znaków specjalnych w wartościach parametrów w formacie URL. Spacje zamieniają się na %20, a nawiasy klamrowe na %7B i %7D.
Gotowy na integrację?
Pobierz aplikację i zacznij testować integrację już dziś.