{"id":14585,"date":"2024-06-21T13:42:16","date_gmt":"2024-06-21T11:42:16","guid":{"rendered":"https:\/\/pomoc.comarch.pl\/cee\/?post_type=ht_kb&#038;p=14585"},"modified":"2024-12-23T11:29:21","modified_gmt":"2024-12-23T10:29:21","slug":"wprowadzenie-platnosci-paypal","status":"publish","type":"ht_kb","link":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/documentation\/wprowadzenie-platnosci-paypal\/","title":{"rendered":"Wprowadzenie: P\u0142atno\u015bci PayPal"},"content":{"rendered":"\n\n\n<p>Artyku\u0142\u00a0 opisuje po\u0142\u0105czenie Comarch ERP Enterprise z systemem p\u0142atno\u015bci online PayPal. Za po\u015brednictwem PayPal mo\u017cliwe jest op\u0142acanie zam\u00f3wie\u0144 przez klienta, dokonywanie obci\u0105\u017ce\u0144 i inicjowanie not kredytowych w przypadku zwrot\u00f3w.<\/p>\n<h3 id=\"definicje-pojec\" >Definicje poj\u0119\u0107<\/h3>\n<p><strong>PayPal<\/strong>:<\/p>\n<p>System p\u0142atno\u015bci online u\u017cywany do kupowania i sprzedawania w handlu internetowym.<\/p>\n<h3 id=\"procesy-i-lancuch-dokumentow-powiazanych\" >Procesy i \u0142a\u0144cuch dokument\u00f3w powi\u0105zanych<\/h3>\n<p>Poni\u017cej opisano procesy biznesowe dotycz\u0105ce p\u0142atno\u015bci PayPal i wynikaj\u0105ce z nich relacje z innymi aplikacjami i jednostkami biznesowymi.<\/p>\n<p>Aby przetworzy\u0107 p\u0142atno\u015b\u0107, p\u0142atno\u015b\u0107 PayPal musi przej\u015b\u0107 przez r\u00f3\u017cne etapy:<\/p>\n<p>Statusy:<\/p>\n<ul>\n<li>[Puste] &#8211; zam\u00f3wienie nie zosta\u0142o jeszcze przes\u0142ane do PayPal. Jest to stan pocz\u0105tkowy dla wszystkich zam\u00f3wie\u0144<\/li>\n<li><strong>\u017b\u0105dane<\/strong> &#8211; zam\u00f3wienie zosta\u0142o przes\u0142ane do systemu PayPal<\/li>\n<li><strong>Potwierdzone<\/strong> &#8211; kupuj\u0105cy zalogowa\u0142 si\u0119 do systemu PayPal, wprowadzi\u0142 swoje dane klienta i potwierdzi\u0142 p\u0142atno\u015b\u0107.<\/li>\n<li><strong>Obci\u0105\u017cono<\/strong> &#8211; wraz z utworzeniem rachunk\u00f3w za dostaw\u0119 przesy\u0142ka zosta\u0142a potwierdzona w systemie PayPal, a kwota obci\u0105\u017cona.<\/li>\n<li><strong>Anulowane<\/strong> &#8211; zam\u00f3wienie zosta\u0142o anulowane (przed wysy\u0142k\u0105 i obci\u0105\u017ceniem konta).<\/li>\n<li><strong>Zwrot \u015brodk\u00f3w<\/strong> &#8211; towary zosta\u0142y zwr\u00f3cone i otrzyma\u0142y zwrot pieni\u0119dzy na konto PayPal kupuj\u0105cego.<\/li>\n<\/ul>\n<p>Aby m\u00f3c korzysta\u0107 z tych proces\u00f3w, funkcja <em>PayPal<\/em> musi by\u0107 aktywowana w sekcji <em>Konfiguracja<\/em> i musz\u0105 zosta\u0107 wprowadzone prawid\u0142owe dane dost\u0119pu. P\u0142atno\u015bci PayPal s\u0105 wymagane tylko dla zam\u00f3wie\u0144 sprzeda\u017cy, kt\u00f3re maj\u0105 termin p\u0142atno\u015bci typu <em>PayPal<\/em>.<\/p>\n<h4 id=\"tworzenie-zamowienia-z-platnoscia-paypal\" >Tworzenie zam\u00f3wienia z p\u0142atno\u015bci\u0105 PayPal<\/h4>\n<p>Zasadniczo ka\u017cde zam\u00f3wienie sprzeda\u017cy mo\u017ce zosta\u0107 op\u0142acone za po\u015brednictwem PayPal, pod warunkiem, \u017ce ustawiono warunek p\u0142atno\u015bci typu <em>PayPal<\/em>.<\/p>\n<p>Status transakcji mo\u017cna sprawdzi\u0107 na zak\u0142adce <em>P\u0142atno\u015bci online<\/em>. Domy\u015blnie status jest pocz\u0105tkowo pusty.<\/p>\n<p>W przypadku, gdy zam\u00f3wienie zosta\u0142o zaimportowane ze sklepu internetowego i zosta\u0142o ju\u017c przes\u0142ane do PayPal, status transakcji zam\u00f3wienia to <em>Potwierdzone<\/em>.<\/p>\n<h4 id=\"lancuch-dokumentow\" >\u0141a\u0144cuch dokument\u00f3w<\/h4>\n<p>W aplikacji <em>Zam\u00f3wienia sprzeda\u017cy<\/em> (widok <em>P\u0142atno\u015bci online<\/em>) znajduje si\u0119 zak\u0142adka <em>P\u0142atno\u015bci online<\/em>\u00a0dla parametr\u00f3w PayPal. Na tej karcie mo\u017cna wy\u015bwietli\u0107 informacje o bie\u017c\u0105cym statusie p\u0142atno\u015bci PayPal.<\/p>\n<p>Karta p\u0142atno\u015bci online zawiera nast\u0119puj\u0105ce pola:<\/p>\n<ul>\n<li><strong>Numer transakcji<\/strong> &#8211; numer transakcji PayPal<\/li>\n<li><strong>Status transakcji<\/strong> &#8211; status transakcji\n<ul>\n<li><em>Za\u017c\u0105dano<\/em> &#8211; p\u0142atno\u015b\u0107 zosta\u0142a za\u017c\u0105dana i musi zosta\u0107 potwierdzona przez klienta.<\/li>\n<li><em>Potwierdzona<\/em> &#8211; p\u0142atno\u015b\u0107 zosta\u0142a potwierdzona przez klienta<\/li>\n<li><em>Pobrano<\/em>&#8211; kwota zosta\u0142a pobrana z konta PayPal klienta<\/li>\n<li><em>Anulowano<\/em> &#8211; p\u0142atno\u015b\u0107 zosta\u0142a anulowana<\/li>\n<li><em>Zwr\u00f3cono<\/em> &#8211; kwota zosta\u0142a przelana z powrotem na konto PayPal klienta.<\/li>\n<\/ul>\n<\/li>\n<li><strong>Numer p\u0142atno\u015bci<\/strong> &#8211; token PayPal p\u0142atno\u015bci<\/li>\n<li><strong>Numer referencyjny<\/strong> &#8211; odpowiada numerowi zam\u00f3wienia i s\u0142u\u017cy do jednoznacznej identyfikacji zam\u00f3wienia.<\/li>\n<li><strong>Zarezerwowana kwota<\/strong> &#8211; kwota zarezerwowana w systemie PayPal dla p\u0142atno\u015bci<\/li>\n<li><strong>Data rezerwacji<\/strong> &#8211; data rezerwacji. Rezerwacja jest domy\u015blnie wa\u017cna przez 3 dni.<\/li>\n<li><strong>Kwota pobrana<\/strong> &#8211; kwota pobrana z konta PayPal kupuj\u0105cego.<\/li>\n<li><strong>Identyfikator \u017c\u0105dania<\/strong> &#8211; unikalny numer \u017c\u0105dania p\u0142atno\u015bci. Generowany za pomoc\u0105 schematu numeracji<\/li>\n<\/ul>\n<h3 id=\"konfiguracja\" >Konfiguracja<\/h3>\n<h4 id=\"schematy-numeracji\" >Schematy numeracji<\/h4>\n<p>Ka\u017cda p\u0142atno\u015b\u0107 PayPal jest identyfikowana przez numer \u017c\u0105dania. Do generowania numer\u00f3w \u017c\u0105da\u0144 wymagany jest schemat numeracji.<\/p>\n<p>Aplikacja <em>Schematy numeracji<\/em> s\u0142u\u017cy do edycji lub tworzenia nowych zakres\u00f3w numer\u00f3w. D\u0142ugo\u015b\u0107 wygenerowanego numeru \u017c\u0105dania nie mo\u017ce przekracza\u0107 127 cyfr.<\/p>\n<h4 id=\"szablony-wiadomosci-e-mail\" >Szablony wiadomo\u015bci e-mail<\/h4>\n<p>W aplikacji <em>Dokumenty<\/em>\u00a0nale\u017cy utworzy\u0107 notatk\u0119 jako szablon powiadomienia e-mail.<\/p>\n<p>Nazwa dokumentu odpowiada tematowi wiadomo\u015bci e-mail. Tre\u015b\u0107 wiadomo\u015bci e-mail jest generowana na podstawie tekstu, przy u\u017cyciu symboli zast\u0119pczych do wstawiania danych zam\u00f3wienia.<\/p>\n<p>Wyja\u015bnienie dost\u0119pnych symboli zast\u0119pczych.<\/p>\n<ul>\n<li>[Gender] &#8211; zwrot grzeczno\u015bciowy (Pani\/Pan)<\/li>\n<li>[Name] &#8211; imi\u0119 i nazwisko klienta<\/li>\n<li>[OrderNumber] &#8211; numer zam\u00f3wienia<\/li>\n<li>[LinkShort:Payment link] &#8211; hiper\u0142\u0105cze do strony PayPal umo\u017cliwiaj\u0105cej zalogowanie si\u0119 i dokonanie p\u0142atno\u015bci. Widoczny tekst hiper\u0142\u0105cza jest okre\u015blony po dwukropku.<\/li>\n<li>[LinkFull] &#8211; pe\u0142ne \u0142\u0105cze do strony PayPal umo\u017cliwiaj\u0105cej logowanie i dokonywanie p\u0142atno\u015bci.<\/li>\n<\/ul>\n<h4 id=\"konfiguracja\" >Konfiguracja<\/h4>\n<p>Parametry funkcji PayPal nale\u017cy ustawi\u0107 w <em>Konfiguracji<\/em>.<\/p>\n<p>Pola:<\/p>\n<ul>\n<li><strong>Konto <\/strong>&#8211; adres e-mail, za pomoc\u0105 kt\u00f3rego nast\u0119puje logowanie do systemu PayPal.<\/li>\n<li><strong style=\"font-size: revert; color: initial;\">Nazwa u\u017cytkownika<\/strong><span style=\"font-size: revert; color: initial;\"> &#8211; nazwa u\u017cytkownika otrzyman\u0105 podczas rejestracji konta sprzedawcy w celu uzyskania dost\u0119pu do interfejsu API.<\/span><\/li>\n<li><strong style=\"font-size: revert; color: initial;\">Has\u0142o API<\/strong><span style=\"font-size: revert; color: initial;\"> &#8211; has\u0142o API otrzymane podczas rejestracji konta sprzedawcy w celu uzyskania dost\u0119pu do interfejsu API. Has\u0142o mo\u017cna wy\u015bwietli\u0107 w ustawieniach profilu konta sprzedawcy.<\/span><\/li>\n<li><strong style=\"font-size: revert; color: initial;\">Podpis API<\/strong><span style=\"font-size: revert; color: initial;\"> &#8211; podpis API otrzymany podczas rejestracji konta sprzedawcy w celu uzyskania dost\u0119pu do API. Podpis mo\u017cna wy\u015bwietli\u0107 w ustawieniach profilu konta sprzedawcy.<\/span><\/li>\n<li><strong style=\"font-size: revert; color: initial;\">URL<\/strong><span style=\"font-size: revert; color: initial;\"> &#8211; adres URL przekierowuj\u0105cy kupuj\u0105cego do formularza p\u0142atno\u015bci PayPal.<\/span>\n<ul>\n<li>Dla operacji na \u017cywo:<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><em>https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_express-checkout&amp;token=<\/em><\/p>\n<ul>\n<li>Dla operacji testowych w sandbox:<\/li>\n<\/ul>\n<p><em>https:\/\/www.sandbox.paypal.com\/cgi-bin\/webscr?cmd=_express-checkout&amp;token=<\/em><\/p>\n<ul>\n<li><strong>Service-Endpoint<\/strong> &#8211; adres URL us\u0142ugi internetowej.\n<ul>\n<li>Dla operacji na \u017cywo:<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><em>https:\/\/api-3t.paypal.com\/2.0\/<\/em><\/p>\n<ul>\n\n<ul>\n<li>Dla operacji testowej w sandbox:<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><em>https:\/\/api-3t.sandbox.paypal.com\/2.0\/<\/em><\/p>\n<ul>\n<li><strong>Schemat numeracji dla ID \u017c\u0105da\u0144<\/strong> &#8211; schemat numeracji do generowania numer\u00f3w \u017c\u0105da\u0144.<\/li>\n<li><strong>Nazwa u\u017cytkownika<\/strong> &#8211; adres -e-mail u\u017cytkownika do wysy\u0142ania wiadomo\u015bci e-mail.<\/li>\n<li><strong>Has\u0142o e-mail<\/strong> &#8211; has\u0142o dost\u0119pu u\u017cytkownika.<\/li>\n<li><strong>Smtp host<\/strong> &#8211; host smtp do wysy\u0142ania wiadomo\u015bci e-mail.<\/li>\n<li><strong>Smtp port<\/strong> -port smtp dla serwera poczty wychodz\u0105cej.<\/li>\n<li><strong style=\"font-size: revert; color: initial;\">Email nadawcy<\/strong> &#8211;<span style=\"font-size: revert; color: initial;\"> adres e-mail, kt\u00f3ry b\u0119dzie u\u017cywany jako nadawca wiadomo\u015bci e-mail z powiadomieniami.<\/span><\/li>\n<li><strong style=\"font-size: revert; color: initial;\">Szablon dokumentu e-mail<\/strong><span style=\"font-size: revert; color: initial;\"> &#8211; szablon dla powiadomie\u0144 e-mail.<\/span><\/li>\n<\/ul>\n<p>Ustawienia b\u0119d\u0105 obowi\u0105zywa\u0107 tylko wtedy, gdy funkcja zosta\u0142a aktywowana w aplikacji <em>Konfiguracja<\/em>.<\/p>\n<h4 id=\"formy-platnosci\" >Formy p\u0142atno\u015bci<\/h4>\n<p>Aby zam\u00f3wienie mog\u0142o zosta\u0107 przes\u0142ane do PayPal, musi ono mie\u0107 metod\u0119 p\u0142atno\u015bci typu <em>PayPal Direct<\/em>.<\/p>\n<p>Form\u0119 p\u0142atno\u015bci nale\u017cy najpierw utworzy\u0107 w aplikacji <em>Formy p\u0142atno\u015bci<\/em>. W tym miejscu nale\u017cy utworzy\u0107 now\u0105 metod\u0119 p\u0142atno\u015bci i wybra\u0107 typ <em>PayPal Direct<\/em>.<\/p>\n<h3 id=\"etapy-przetwarzania\" >Etapy przetwarzania<\/h3>\n<h4 id=\"akcja-platnosc-online-zadaj-platnosci-online\" >Akcja [P\u0142atno\u015b\u0107 online: \u017b\u0105daj p\u0142atno\u015bci online]<\/h4>\n<p>Akcja [<strong>P\u0142atno\u015b\u0107 online: \u017b\u0105daj p\u0142atno\u015bci online<\/strong>] w aplikacji <em>Zam\u00f3wienia sprzeda\u017cy<\/em> s\u0142u\u017cy do \u017c\u0105dania p\u0142atno\u015bci od PayPal. W tym celu wykorzystywane s\u0105 dane zam\u00f3wienia sprzeda\u017cy, takie jak lista artyku\u0142\u00f3w i adres e-mail klienta. Ponadto identyfikator \u017c\u0105dania zam\u00f3wienia jest generowany za pomoc\u0105 odpowiedniego schematu numeracji.<\/p>\n<p>Nast\u0119pnie wywo\u0142ywana jest us\u0142uga internetowa PayPal i inicjowana jest nowa p\u0142atno\u015b\u0107. W odpowiedzi PayPal wysy\u0142a numer p\u0142atno\u015bci (token). Numer p\u0142atno\u015bci s\u0142u\u017cy do wygenerowania \u0142\u0105cza, kt\u00f3re mo\u017ce zosta\u0107 wywo\u0142ane przez klient\u00f3w i otwiera formularz PayPal w przegl\u0105darce, w kt\u00f3rym klient mo\u017ce wprowadzi\u0107 swoje dane dost\u0119pu lub dane karty, aby dokona\u0107 p\u0142atno\u015bci. Link ten jest wysy\u0142any do klienta w wiadomo\u015bci e-mail.<\/p>\n<p>Nowy status transakcji to <em>Za\u017c\u0105dano<\/em>\u00a0(REQUESTED).<\/p>\n<h4 id=\"akcja-platnosci-online-zweryfikuj-transakcje\" >Akcja [P\u0142atno\u015bci online: Zweryfikuj transakcj\u0119]<\/h4>\n<p>Za pomoc\u0105 akcji [<strong>P\u0142atno\u015bci online: Zweryfikuj transakcj\u0119<\/strong>] akcja w aplikacji <em>Zam\u00f3wienia sprzeda\u017cy<\/em> wysy\u0142a zapytanie o aktualny status p\u0142atno\u015bci w systemie PayPal. Akcja ta musi zosta\u0107 wywo\u0142ana w celu uzyskania numeru transakcji wymaganego do zaksi\u0119gowania lub anulowania p\u0142atno\u015bci.<\/p>\n<section class=\"document-alert-box indicator\"><div class=\"document-alert-title\">Wskaz\u00f3wka<\/div><div class=\"document-alert-content\"> Aby otrzyma\u0107 numer transakcji, klient musi potwierdzi\u0107 p\u0142atno\u015b\u0107 w formularzu PayPal!<\/div><\/section>\n<p>Je\u015bli p\u0142atno\u015b\u0107 w systemie PayPal powiod\u0142a si\u0119, status zmienia si\u0119 na <em>Potwierdzony<\/em>. To ko\u0144czy rezerwacj\u0119 kwoty.<\/p>\n<h4 id=\"akcja-platnosci-online-anuluj-autoryzacje-wstepna\" >Akcja [P\u0142atno\u015bci online: Anuluj autoryzacj\u0119 wst\u0119pn\u0105]<\/h4>\n<p>Za pomoc\u0105 akcji\u00a0[<strong>P\u0142atno\u015bci online: Anuluj autoryzacj\u0119 wst\u0119pn\u0105<\/strong>] w aplikacji <em>Zam\u00f3wienia sprzeda\u017cy<\/em> p\u0142atno\u015b\u0107 zostaje anulowana. Jest to mo\u017cliwe tylko wtedy, gdy kwota zosta\u0142a jedynie zarezerwowana i nie zosta\u0142a jeszcze pobrana.<\/p>\n<p>Je\u015bli cofni\u0119cie si\u0119 powiedzie, status p\u0142atno\u015bci zmieni si\u0119 na <em>Anulowana<\/em>.<\/p>\n<h4 id=\"opis-procesu-zaksieguj-platnosci-paypal\" >Opis procesu <em>Zaksi\u0119guj p\u0142atno\u015bci PayPal<\/em><\/h4>\n<p>P\u0142atno\u015bci PayPal s\u0105 pobierane po dostarczeniu zam\u00f3wienia dostawy, tj. po wystawieniu rachunku za dostaw\u0119.<\/p>\n<p>Kwota p\u0142atno\u015bci wynika z warto\u015bci rachunku za dostaw\u0119. Kwot\u0119 obci\u0105\u017cenia mo\u017cna zobaczy\u0107 na zak\u0142adce <em>P\u0142atno\u015bci online<\/em> w aplikacji <em>Zam\u00f3wienia sprzeda\u017cy<\/em>.<\/p>\n<h4 id=\"opis-procesu-noty-kredytowe-i-cofniecia\" >Opis procesu <em>Noty kredytowe i cofni\u0119cia<\/em><\/h4>\n<p>Istniej\u0105 dwa sposoby odwr\u00f3cenia p\u0142atno\u015bci PayPal za pomoc\u0105 noty uznaniowej.<\/p>\n<p>Pierwsz\u0105 opcj\u0105 jest anulowanie zam\u00f3wienia dostawy, dla kt\u00f3rego utworzono rachunki za dostaw\u0119 w aplikacji <em>Zam\u00f3wienia dostawy<\/em>. Je\u015bli dostawa nale\u017cy do zam\u00f3wienia PayPal, anulowana kwota zostanie automatycznie przelana na konto PayPal.<\/p>\n<p>Drug\u0105 opcj\u0105 jest wprowadzenie zwrot\u00f3w. W tym celu dost\u0119pna jest aplikacja <em>Zwroty od klient\u00f3w<\/em>. Aplikacja <em>Zwroty od klient\u00f3w<\/em>\u00a0zapewnia, \u017ce paragon jest powi\u0105zany z zam\u00f3wieniem jako zwrot i tworzone jest zlecenie kredytowe. Je\u015bli dla tego zam\u00f3wienia zostanie utworzona faktura, kwota zostanie zaksi\u0119gowana w systemie PayPal.<\/p>\n<p>\u00a0<\/p>\n","protected":false},"author":19,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"class_list":["post-14585","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-paypal"],"_links":{"self":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/14585","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/users\/19"}],"replies":[{"embeddable":true,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/comments?post=14585"}],"version-history":[{"count":4,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/14585\/revisions"}],"predecessor-version":[{"id":22465,"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/ht_kb\/14585\/revisions\/22465"}],"wp:attachment":[{"href":"https:\/\/pomoc.comarch.pl\/cee\/index.php\/wp-json\/wp\/v2\/media?parent=14585"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}