Przejdź do treści

Integracja płatności z własnym systemem

Wyświetleń: 13662 1 min czytania

Czasem po dokonaniu płatności (np. za fakturę) potrzebna jest zmiana we własnym systemie (np. aby odznaczyć, że klient opłacił daną usługę).

W Fakturowni można to wykonać wpisując w polu Ustawienia > Płatności online > Ustawienia > Wywołanie API url na który zostanie wywołane po dokonaniu płatności. 

Wywołanie to może mieć postać:

http://www.twojaAplikacja.pl/api?token={{token}}&adres_email={{email}}&firma={{company}}&invoice_id={{invoice_id}}

W wywołaniu API (metoda GET) możemy przekazać wszystkie niezbędne dane odnośnie płatności:

{{promocode}}, {{first_name}}, {{last_name}}, {{email}}, {{phone}}, {{post_code}}, {{city}}, {{street}}, {{country}}, {{comment}}, {{quantity}}, {{invoice_name}}, {{invoice_tax_no}}, {{invoice_post_code}}, {{invoice_city}}, {{invoice_street}}, {{invoice_country}}, {{invoice_comment}}, {{generate_invoice}}, {{name}}, {{description}}, {{oid}}, {{paid}}, {{price}}, {{product_id}}, {{id}}, {{referrer}}, {{token}}, {{invoice_id}}

Czy ten wpis był pomocny?

Udostępnij

Główna odpowiedź Piotr 2018-05-07 10:28

Witam,
API Fakturowni nie wysyła re-questów do innych systemów poprzez API, tylko wysyła re-sponse w odpowiedzi na re-quest.

To użytkownik musi wysłać zapytanie z własnego systemu do Fakturowni poprzez API, a Fakturownia poprzez API może jedynie odpowiedzieć.
Pozdrawiam,
Piotr

Komentarze (12)

Piotr 2024-12-30 11:00 Odpowiedź

Dzień dobry, 

ścieżka jest poprawna. Po wybraniu opcji “Płatności online” należy wybrać druga zakładkę “Ustawienia” w głównym menu. Zrzut ekranu w załączniku. 

Pozdrawiam serdecznie, 

Piotr 

Anonymous 2024-12-30 10:33

Dzień dobry,
Wątek wskazuje że dostęp do tej funkcji jest dostępny pod ścieżką:

Ustawienia > Płatności online > Ustawienia > Wywołanie API url na który zostanie wywołane po dokonaniu płatności.

Czy to jest dalej aktualna informacja bo nie mogę jej znaleźć?

Piotr 2023-09-11 10:21 Odpowiedź

Dzień dobry,
odpowiadam na powyższe pytania:
ad 1. “Wywołanie API” wykonuje się jeśli transakcja zakończyła się sukcesem, czyli provaider potwierdził płatność.
Zatem jak najbardziej można skorzystać z tego rozwiązania:
{{paid}} to wartość logiczna i przyjmuje albo true albo false.

ad 2. “URL po poprawnej płatności” i “URL po nieudanej płatności” - to są linki które pojawią się użytkownikom w przeglądarce po zakończeniu płatności. w tej konkretnym sytuacji nie będzie przydatnym rozwiązaniem.

Pozdrawiam,
Piotr

Piotr 2023-09-04 10:15 Odpowiedź

Dzień dobry,
dziękuję za kontakt.
Zgłoszenie trafiło do programisty w celu analizy. Jak tylko otrzymam odpowiedź przekaże ją Panu.
Pozdrawiam,
Piotr

Anonymous 2023-08-30 13:21

Interesuje mnie sytuacja przeslania powiadomienia do naszego systemu jedynie jesli platnosc przebiegla prawidlowo.

Zastanawiam sie wiec nad 2 opcjami:

  1. Uzupelnienie pola: “Wywołanie API”: https://adresaplikacji.pl/?tinvoice_id={{invoice_id}}&paid={{paid}}

Pytanie w takiej sytuacji jakie wartosci moze przyjac {{paid}}? Na tej podstawie moglibysmy ustalic czy dokonac aktualizacji u siebie w systemie.

  1. Uzupelnienie pola: “URL po poprawnej płatności”. Rozumiem, ze ten adres zostalaby przeslana infromacja jedynie jesli platnosc przebiegla prawidlowo, tak wiec wystarczyloby podac jedynie nr faktury zeby namierzyc ja u siebie w systemie: https://adresaplikacji.pl/?tinvoice_id={{invoice_id}} ?
Piotr 2020-09-09 14:19 Odpowiedź

Dzień dobry,
url po poprawnej lub niepoprawnej płatności zostaje wywołany w przypadku opłacenia z linku.
Sama zmiana statusu dokumentu nie powoduje wywołania url.
Pozdrawiam,
Piotr

Anonymous 2020-09-05 13:30

Witam. Czy system wywołyje url tylko w przypadku opłacenia z linku znajdującego się na fakturze czy jeśli np oznaczymy fakturę ręcznie jako opłaconą to również system wywołuje podany url?

Piotr 2018-05-07 13:03 Odpowiedź

W tym polu użytkownik wpisuje adres, na jaki ma zostać wysłany response po dokonaniu płatności. W pierwszym poście padło pytanie “Czy Fakturownia za jakiś czas ponowi próbę odpytania naszego API” - czyli request. Tak jak napisałem wcześniej, Fakturownia nie wysyła requestów (nie odpytuje) do innych API. Może przesłać response na request.
Pole wspomniane w instrukcji zawiera powiązanie dla webhook - po dokonaniu płatności do Fakturowni jest wysyłany request, natomiast odpowiedź jest kierowana na adres, który został podany w tym polu. Zgodnie z RFC, response jest wysyłany na podany adres bez sprawdzania jego dostępności.

Pozdrawiam,
Piotr

Anonymous 2018-05-07 11:25

Panie Piotrze, chyba jednak to co Pan mówi, nie jest spójne z dokumentacją powyżej. Wg instrukcji (powyższego postu) wynika, że w konfiguracji ustawiamy adres WŁASNEGO api, czyli Fakturownia powiadamia nasz wewnętrzny system po dokonaniu płatności - co jest dość logiczne.

Piotr 2018-05-07 10:28 Główna odpowiedź

Witam,
API Fakturowni nie wysyła re-questów do innych systemów poprzez API, tylko wysyła re-sponse w odpowiedzi na re-quest.

To użytkownik musi wysłać zapytanie z własnego systemu do Fakturowni poprzez API, a Fakturownia poprzez API może jedynie odpowiedzieć.
Pozdrawiam,
Piotr

Anonymous 2018-05-07 09:36

Co się stanie w sytuacji, gdy nasze API będzie niedostępne? Czy Fakturownia za jakiś czas ponowi próbę odpytania naszego API, czy może jedynym rozwiązaniem tej sytuacji jest “ręczne” odpytanie API Fakturowni, o opłacone faktury z dnia dzisiejszego?

info@infracom.pl 2018-01-03 23:30

Przydałoby się przy niektórych zmiennych dać opis, bo nie do końca wiadomo jaki wynik dadzą, a nie można wykonać testu na konkretnej fakturze :(