API PANELU ADMINISTRACYJNEGO SPRZEDAWCY

Transkrypt

1 Dział Pomocy Technicznej Dotpay ul. Wielicka 72, Kraków tel faks API PANELU ADMINISTRACYJNEGO SPRZEDAWCY Wersja

2 SPIS TREŚCI Strona 2 / 61 WSTĘP... 3 I. CHARAKTERYSTYKA I ADRES INTERFEJSU... 4 II. UWIERZYTELNIANIE I AUTORYZACJA... 5 III. FORMAT DANYCH WEJŚCIA / WYJŚCIA... 6 IV. PAGINACJA... 8 V. ZASOBY V. 1. ACCOUNTS/ LISTA SKLEPÓW ID UŻYTKOWNIKA accounts/int: account_id/ szczegóły sklepu ID accounts/int: account_id/channels/ lista kanałów płatności sklepu ID accounts/int: account_id/payment_links/ utworzenie linku płatniczego accounts/int: account_id/payment_links/string: token/ usunięcie linku płatniczego accounts/int: account_id/payment_links/ lista linków płatniczych accounts/int: account_id/payment_links/string: token/ szczegóły linku płatniczego accounts/int: account_id/payout/ wypłata środków z salda sklepu ID V. 2. OPERATIONS/ LISTA OPERACJI operations/string: operation_number/ szczegóły pojedynczej operacji operations/string: operation_number/operations/ lista operacji zawartych w operacji payout V. 3. PAYMENTS/ LISTA OPERACJI PŁATNOŚCI payments/string: operation_number/ szczegóły pojedynczej operacji płatności payments/string: operation_number/mark_as_complete/ oznaczenie flagą complete payments/string: operation_number/mark_as_complete/ usunięcie flagi complete payments/string: operation_number/refund/ zwrot operacji płatności V. 4. V1/REPORTS/ LISTA RAPORTÓW TABELA ROUTINGU DZIENNIK ZMIAN... 61

3 WSTĘP Niniejszy dokument opisuje interfejs systemu płatności oferowanego przez serwis dotpay i przeznaczony jest zarówno dla podmiotów zainteresowanych ofertą serwisu, jak i osób zajmujących się wdrożeniem systemu. Strona 3 /61

4 I. CHARAKTERYSTYKA I ADRES INTERFEJSU Strona 4 / 61 API panelu administracyjnego Sprzedawcy został wykonany w stylu architektury REST. Adresy pod którymi dostępny jest interfejs to: środowisko produkcyjne: środowisko testowe:

5 II. UWIERZYTELNIANIE I AUTORYZACJA Uwierzytelnianie do API następuje poprzez podanie metodą HTTP Basic authentication loginu i hasła użytkownika analogicznych dla danych logowania do GUI panelu administracyjnego Sprzedawcy. Strona 5 /61 Po wywołaniu danego zasobu API zostanie zwrócona odpowiedź z odpowiednim kodem odpowiedzi HTTP. Przykładowo dla zasobu: po wykonaniu żądania z błędnym loginem / hasłem: nagłówki żądania: GET /test_seller/api/accounts/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic ZGFzZGFzOmRhc2RzYQ== zostanie zwrócona nagłówki odpowiedzi: HTTP/ Unauthorized WWW-Authenticate: Basic realm="api" Vary: Accept Allow: GET, HEAD, OPTIONS "detail": "Invalid username/password" Jeśli zaistnieje taka potrzeba, to jak w powyższym przykładzie zostanie zwrócona własność detail z tekstowym opisem błędu. Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 200 OK ok 401 Unauthorized nie udało się uwierzytelnić 403 Forbidden brak uprawnień

6 III. FORMAT DANYCH WEJŚCIA / WYJŚCIA Strona 6 / 61 API ma możliwość komunikacji w formacie json domyślnie lub xml. Wybór formatowania odbywa się za pomocą przesłania nagłówków Accept oraz Content-Type lub dodatkowego parametru format przekazanego metodą GET, którego wartością jest nazwa danego formatu json lub xml. Przykładowo dla żądania zasobu: z nagłówkami: GET /test_seller/api/accounts/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json zostanie zwrócona "count": 1, "next": null, "previous": null, "results": [ "href": " "id": "443005", "status": "active", "name": "Hoan Kiem Megastore", "mcc_code": "7273", "main_url": " "config": "urlc": " "block_external_urlc": false, "pin": "emhbaulyaqknforbrl2ewk0hhz5c7rkx" ] dla nagłówków: GET /test_seller/api/accounts/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/xml Content-Type: application/xml zostanie zwrócona <root> <count>1</count> <next><next/> <previous><previous/> <results> <list-item> <href> <id>443005</id> <status>active</status> <name>hoan Kiem Megastore</name> <mcc_code>7273</mcc_code> <main_url>

7 <config> <urlc> <block_external_urlc>false</block_external_urlc> <pin>emhbaulyaqknforbrl2ewk0hhz5c7rkx</pin> </config> </list-item> </results> </root> Strona 7 /61 W przypadku wywołania zasobów z parametrem format jak w poniższych przykładach, API zwróci odpowiedź analogiczną do powyższych.

8 IV. PAGINACJA Strona 8 / 61 Dla żądań wymagających zwrócenia większej ilości danych odpowiedź API jest paginowana domyślnie dla jednej strony wyświetlane jest maksymalnie 100 elementów. Odpowiedź zawiera własności next oraz previous, w których znajduje się adres kolejnej / poprzedniej strony odpowiedzi, natomiast we własności count znajduje się ilość obiektów zwróconych w całej odpowiedzi. Znaczenie parametrów możliwych do przesyłania w żądaniu w celu filtrowania odpowiedzi: WŁASNOŚĆ TYP ZNACZENIE / OPIS page int numer strony page_size int Ilość elementów wyświetlana na jednej stronie minimalna wartość: 1 maksymalna wartość: 100 Przykładowo dla zasobu: zostanie zwrócona odpowiedź jak poniższy fragment: "count": 538, "next": " "previous": " "results": [ "href": " "number": "M ", "creation_datetime": " T10:28: ", "type": "payment", "status": "new", "amount": "41.00", "currency": "PLN", "original_amount": "10.23", "original_currency": "EUR", "account_id": "443005", "related_operation": null, "description": "Zamowienie ", "control": "Bdt1Gc2Q2iRQ1EeW", "payer": "first_name": "Jan", "last_name": "Kowalski", " ": "jan.kowalski@example.com", "href": " "number": "M ", "creation_datetime": " T10:59: ", "type": "payment",

9 "status": "completed", "amount": "1.00", "currency": "PLN", "original_amount": "1.00", "original_currency": "PLN", "account_id": "443005", "related_operation": null, "description": "Order 1265", "control": "ahh39mgmywm3wm4azzo18ja0y2fknzfz", "payer": "first_name": "John", "last_name": "Smith", " ": Strona 9 /61

10 V. ZASOBY Strona 10 / 61 V. 1. accounts/ lista sklepów ID użytkownika Zasób zwraca listę wszystkich sklepów, do których zalogowany użytkownik posiada uprawnienia. przykładowe żądanie: nagłówki żądania: GET /test_seller/api/accounts/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, HEAD, OPTIONS "count": 2, "next": null, "previous": null, "results": [ "href": " "id": "470707", "status": "active", "name": "HK Test 2", "mcc_code": "3709", "main_url": null, "config": "urlc": " "block_external_urlc": true, "pin": "74fr6JxOy5jxJ2Qz", "href": " "id": "443005", "status": "active", "name": "Hoan Kiem Megastore", "mcc_code": "7273", "main_url": " "config": "urlc": " "block_external_urlc": false, "pin": "emhbaulyaqknforbrl2ewk0hhz5c7rkx" ]

11 Znaczenie własności zwracanych w tablicy results: WŁASNOŚĆ TYP ZNACZENIE / OPIS href string adres API, pod którym znajduje się odpowiedź dla danego sklepu ID Strona 11 /61 id int numer sklepu ID status string status sklepu ID name string nazwa sklepu ID mcc_code string kod kategorii sprzedaży MCC main_url string adres sprzedażowy sklepu ID config.urlc string adres powiadomień urlc config.block_external_urlc bool blokuj zewnętrzne urlc config.pin string PIN Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/accounts/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?>

12 Strona 12 / 61 HTTP status code: stdclass Object [count] => 2 [next] => [previous] => [results] => Array [0] => stdclass Object [href] => [id] => [status] => active [name] => HK Test 2 [mcc_code] => 3709 [main_url] => [config] => stdclass Object [urlc] => [block_external_urlc] => 1 [pin] => 74fr6JxOy5jxJ2Qz [1] => stdclass Object [href] => [id] => [status] => active [name] => Hoan Kiem Megastore [mcc_code] => 7273 [main_url] => [config] => stdclass Object [urlc] => [block_external_urlc] => [pin] => emhbaulyaqknforbrl2ewk0hhz5c7rkx

13 accounts/int: account_id/ szczegóły sklepu ID Zasób zwraca szczegóły danego sklepu ID do którego zalogowany użytkownik posiada uprawnienia. przykładowe żądanie: Strona 13 /61 nagłówki żądania: GET /test_seller/api/accounts/443005/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, HEAD, OPTIONS "href": " "id": "443005", "status": "active", "name": "Hoan Kiem Megastore", "mcc_code": "7273", "main_url": " "config": "urlc": " "block_external_urlc": false, "pin": "emhbaulyaqknforbrl2ewk0hhz5c7rkx" Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 200 OK ok 404 Not Found nie znaleziono sklepu Własności zwrócone w odpowiedzi zostały opisane w rozdziale accounts lista sklepów ID użytkownika powyżej.

14 Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. Strona 14 / 61 żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/accounts/443005/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?> HTTP status code: stdclass Object [href] => [id] => [status] => active [name] => Hoan Kiem Megastore [mcc_code] => 7273 [main_url] => [config] => stdclass Object [urlc] => [block_external_urlc] => [pin] => uevbmsza6esmhi9v74fr6jxoy5jxj2qz

15 accounts/int: account_id/channels/ lista kanałów płatności sklepu ID Zasób zwraca listę dostępnych kanałów płatności dla danego sklepu ID. przykładowe żądanie: Strona 15 /61 nagłówki żądania: GET /test_seller/api/accounts/443005/channels/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, HEAD, OPTIONS fragment odpowiedzi: [ "id": 0, "name": "Credit cards", "logo": " payment_channel_logo/51651fe3dadfce4f1697d53b/", "group": "credit_cards", "is_blocked_by_seller": false, "is_disabled": false, "is_offline": false, "id": 77, "name": "FerBuy", "logo": " payment_channel_logo/5582b7e8eb0a1945e1bafcb2/", "group": "fast_transfers", "is_blocked_by_seller": false, "is_disabled": false, "is_offline": false, "id": 21, "name": "VIA - Moje Rachunki", "logo": " payment_channel_logo/5304f103eb0a /", "group": "cash", "is_blocked_by_seller": false, "is_disabled": false, "is_offline": false,

16 Znaczenie zwracanych kodów odpowiedzi HTTP: Strona 16 / 61 HTTP status code 200 OK ok OPIS 404 Not Found nie znaleziono sklepu Znaczenie własności zwracanych w odpowiedzi: WŁASNOŚĆ TYP ZNACZENIE / OPIS id int numer kanału płatności name string nazwa kanału płatności logo string adres url, pod którym znajduje się logotyp kanału płatności group string grupa do jakiej należy kanał płatności is_blocked_by_seller bool blokada kanału przez Sprzedawcę is_disabled bool kanał wyłączony is_offline bool kanał w trybie offline, tj. nie jest w stanie zaksięgować płatności w czasie rzeczywistym Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/accounts/443005/channels/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL;

17 print_rjson_decode$response; echo '</pre>';?> Strona 17 /61 fragment odpowiedzi: HTTP status code: Array [0] => stdclass Object [id] => 0 [name] => Credit cards [logo] => payment_channel_logo/51651fe3dadfce4f1697d53b/ [group] => credit_cards [is_blocked_by_seller] => [is_disabled] => [is_offline] => [1] => stdclass Object [id] => 77 [name] => FerBuy [logo] => payment_channel_logo/5582b7e8eb0a1945e1bafcb2/ [group] => fast_transfers [is_blocked_by_seller] => [is_disabled] => [is_offline] => [2] => stdclass Object [id] => 21 [name] => VIA - Moje Rachunki [logo] => payment_channel_logo/5304f103eb0a / [group] => cash [is_blocked_by_seller] => [is_disabled] => [is_offline] =>

18 accounts/int: account_id/payment_links/ utworzenie linku płatniczego Strona 18 / 61 Zasób pozwala stworzyć link płatniczy dla danego sklepu ID. przykładowe żądanie: nagłówki żądania: POST /test_seller/api/accounts/443005/payment_links/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== żądanie: "amount": "99.11", "currency": "PLN", "description": "Payment for order", "control": "202cb962ac59075b964b07152d234b70", "language": "pl", "channel_id": 4, "ch_lock": "1", "onlinetransfer": "1", "redirection_type": "0", "url": " "urlc": " "expiration_datetime": " T16:48:00", "payer": "first_name": "John", "last_name": "Smith", " ": "john.smith@example.com", "phone": " ", "address": "street": "Wielicka", "building_number": 72, "postcode": "30-552", "city": "Krakow", "region": "Malopolska", "country": "POL", "recipient": "account_number": "PL ", "company": "PJ Shop", "first_name": "Patrick", "last_name": "Jones", "address": "street": "Marszalkowska", "building_number": 100, "postcode": "00-576", "city": "Warszawa" nagłówki odpowiedzi: HTTP/ Created Vary: Accept

19 Allow: GET, POST, HEAD, OPTIONS Location: payment_links/5e60d3r728trixvagqj7bds19r0irm31/ Strona 19 /61 "href": " payment_links/5e60d3r728trixvagqj7bds19r0irm31/", "payment_url": " "token": "5e60d3r728trixvagqj7bds19r0irm31", "amount": "99.11", "currency": "PLN", "description": "Payment for order", "control": "202cb962ac59075b964b07152d234b70", "language": "pl", "channel_id": 4, "ch_lock": true, "onlinetransfer": true, "redirection_type": 0, "url": " "urlc": " "expiration_datetime": " T16:48:00", "payer": "first_name": "John", "last_name": "Smith", " ": "phone": " ", "address": "street": "Wielicka", "building_number": "72", "flat_number": null, "postcode": "30-552", "city": "Krakow", "region": "Malopolska", "country": "POL", "recipient": "account_number": "PL ", "company": "PJ Shop", "first_name": "Patrick", "last_name": "Jones", "address": "street": "Marszalkowska", "building_number": "100", "flat_number": null, "postcode": "00-576", "city": "Warszawa" Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 201 Created utworzono link 404 Not Found nie znaleziono sklepu

20 Znaczenie własności przesyłanych w żądaniu z wyjątkiem href, payment_url, token oraz zwracanych w odpowiedzi: Strona 20 / 61 WŁASNOŚĆ TYP ZNACZENIE / OPIS href string adres API, pod którym znajdują się szczegóły utworzonego linku payment_url string wygenerowany link płatniczy token string token identyfikujący płatność amount decimal kwota currency string waluta format: ISO 4217 description string opis płatności control string Parametr pozwalający na przechowanie ciągu np. numeru zamówienia ze sklepu Sprzedawcy o długości do 1000 znaków. Parametr w formie niezmienionej jest odsyłany do serwisu Sprzedawcy w powiadomieniu URLC language string język format: ISO channel_id string numer kanału płatności ch_lock string zablokowanie określonego kanału płatności onlinetransfer string sposób wyświetlenia kanałów offline na stronie płatności UWAGA: parametr tymczasowo niedostępny redirection_type string metoda odwołania do serwisu Sprzedawcy po dokonanej płatności url string adres na który jest realizowany powrót do Sprzedawcy urlc string adres na który zostanie przesłana notyfikacja URLC expiration_datetime string data ważności linku format: YYYY-MM-DDTHH:MM:SS payer.first_name string imię osoby płacącej

21 payer.last_name string nazwisko osoby płacącej payer. string osoby płacącej Strona 21 /61 payer.phone string telefon osoby płacącej payer.address.street string ulica payer.address.building_number string numer budynku payer.address.flat_number string numer mieszkania payer.address.postcode string kod pocztowy payer.address.city string miasto payer.address.region string region payer.address.country string państwo format: ISO alfa-3 recipient.account_number string numer rachunku odbiorcy płatności format: IBAN recipient.company string nazwa firmy odbiorcy płatności recipient.first_name string imię odbiorcy płatności recipient.last_name string nazwisko odbiorcy płatności recipient.address.street string ulica recipient.address.building_number string numer budynku recipient.address.flat_number string numer mieszkania recipient.address.postcode string kod pocztowy recipient.address.city string miasto Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $fields = array 'amount' => '99.11', 'currency' => 'PLN', 'description' => 'Payment for order', 'control' => '202cb962ac59075b964b07152d234b70',

22 Strona 22 / 61 'language' => 'pl', 'channel_id' => 4, 'ch_lock' => "1", 'onlinetransfer' => "1", 'redirection_type' => "0", 'url' => ' 'urlc' => ' 'expiration_datetime' => ' T16:48:00', 'payer' => array 'first_name' => 'John', 'last_name' => 'Smith', ' ' => 'john.smith@example.com', 'phone' => ' ', 'address' => array 'street' => 'Wielicka', 'building_number' => 72, 'postcode' => '30-552', 'city' => 'Krakow', 'region' => 'Malopolska', 'country' => 'POL', 'recipient' => array 'account_number' => 'PL ', 'company' => 'PJ Shop', 'first_name' => 'Patrick', 'last_name' => 'Jones', 'address' => array 'street' => 'Marszalkowska', 'building_number' => 100, 'postcode' => '00-576', 'city' => 'Warszawa', ; $data=json_encode$fields; $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," accounts/443005/payment_links/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; curl_setopt $ch, CURLOPT_POST, 1; curl_setopt $ch, CURLOPT_POSTFIELDS, $data; curl_setopt $ch, CURLOPT_HTTPHEADER, array '', 'Content-Length: '.strlen$data; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?>

23 HTTP status code: stdclass Object [href] => payment_links/5e60d3r728trixvagqj7bds19r0irm31/ [payment_url] => [token] => 5e60d3r728trixvagqj7bds19r0irm31 [amount] => [currency] => PLN [description] => Payment for order [control] => 202cb962ac59075b964b07152d234b70 [language] => pl [channel_id] => 4 [ch_lock] => 1 [onlinetransfer] => 1 [redirection_type] => 0 [url] => [urlc] => [expiration_datetime] => T16:48:00 [payer] => stdclass Object [first_name] => John [last_name] => Smith [ ] => john.smith@example.com [phone] => [address] => stdclass Object [street] => Wielicka [building_number] => 72 [flat_number] => [postcode] => [city] => Krakow [region] => Malopolska [country] => POL [recipient] => stdclass Object [account_number] => PL [company] => PJ Shop [first_name] => Patrick [last_name] => Jones [address] => stdclass Object [street] => Marszalkowska [building_number] => 100 [flat_number] => [postcode] => [city] => Warszawa Strona 23 /61

24 accounts/int: account_id/payment_links/string: token/ usunięcie linku płatniczego Strona 24 / 61 Zasób pozwala usunąć stworzony link płatniczy dla danego sklepu ID. przykładowe żądanie: nagłówki żądania: DELETE /test_seller/api/accounts/443005/payment_links/5e60d3r728trixvagqj7bds19r0irm31/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ No Content Vary: Accept Allow: GET, PUT, PATCH, DELETE, HEAD, OPTIONS Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 204 No Content usunięto link 404 Not Found nie znaleziono sklepu Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/accounts/443005/payment_links/5e60d3r728trixvagqj7bds19r0irm31/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; curl_setopt $ch, CURLOPT_CUSTOMREQUEST, "DELETE"; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch;

25 echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?> Strona 25 /61 HTTP status code:

26 accounts/int: account_id/payment_links/ lista linków płatniczych Strona 26 / 61 Zasób zwraca listę linków płatniczych dla danego sklepu ID. przykładowe żądanie: nagłówki żądania: GET /test_seller/api/accounts/443005/payment_links/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, POST, HEAD, OPTIONS fragment odpowiedzi: "count": 116, "next": " payment_links/?page=2", "previous": null, "results": [ "href": " payment_links/3drilk63fknyko778yziran6yx603xvo/", "payment_url": " "token": "3drilk63fknyko778yziran6yx603xvo", "amount": "99.11", "currency": "PLN", "description": "Payment for order", "control": "202cb962ac59075b964b07152d234b70", "language": "pl", "channel_id": 4, "ch_lock": true, "onlinetransfer": true, "redirection_type": 0, "url": " "urlc": " "expiration_datetime": " T16:48:00", "payer": "first_name": "John", "last_name": "Smith", " ": "john.smith@example.com", "phone": " ", "address": "street": "Wielicka", "building_number": "72", "flat_number": null, "postcode": "30-552", "city": "Krakow", "region": "Malopolska", "country": "POL"

27 , "recipient": "account_number": "PL ", "company": "PJ Shop", "first_name": "Patrick", "last_name": "Jones", "address": "street": "Marszalkowska", "building_number": "100", "flat_number": null, "postcode": "00-576", "city": "Warszawa", "href": " payment_links/jov2viovv0tlz22wwy2svtunb2sm5x4o/", "payment_url": " "token": "jov2viovv0tlz22wwy2svtunb2sm5x4o", "amount": "99.11", "currency": "PLN", "description": "platnosc dla Jan Kowalski", "control": null, "language": "pl", "channel_id": null, "ch_lock": null, "onlinetransfer": null, "redirection_type": 0, "url": " "urlc": null, "expiration_datetime": null, "payer": "first_name": "John", "last_name": "Smith", " ": "phone": null, "address": "street": "Warszawska", "building_number": "1", "flat_number": null, "postcode": "11-111", "city": "Krakow", "region": null, "country": "POL", "recipient": "account_number": "", "company": null, "first_name": null, "last_name": null, "address": "street": null, "building_number": null, "flat_number": null, "postcode": null, "city": null, Strona 27 /61

28 Znaczenie zwracanych kodów odpowiedzi HTTP: Strona 28 / 61 HTTP status code 200 OK ok OPIS 404 Not Found nie znaleziono sklepu Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/accounts/443005/payment_links/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?> fragment odpowiedzi: HTTP status code: stdclass Object [count] => 116 [next] => payment_links/?page=2 [previous] => [results] => Array [0] => stdclass Object [href] => payment_links/3drilk63fknyko778yziran6yx603xvo/ [payment_url] => [token] => 3drilk63fknyko778yziran6yx603xvo

29 [amount] => [currency] => PLN [description] => Payment for order [control] => 202cb962ac59075b964b07152d234b70 [language] => pl [channel_id] => 4 [ch_lock] => 1 [onlinetransfer] => 1 [redirection_type] => 0 [url] => [urlc] => [expiration_datetime] => T16:48:00 [payer] => stdclass Object [first_name] => John [last_name] => Smith [ ] => john.smith@example.com [phone] => [address] => stdclass Object [street] => Wielicka [building_number] => 72 [flat_number] => [postcode] => [city] => Krakow [region] => Malopolska [country] => POL [recipient] => stdclass Object [account_number] => PL [company] => PJ Shop [first_name] => Patrick [last_name] => Jones [address] => stdclass Object [street] => Marszalkowska [building_number] => 100 [flat_number] => [postcode] => [city] => Warszawa [1] => stdclass Object [href] => payment_links/jov2viovv0tlz22wwy2svtunb2sm5x4o/ [payment_url] => [token] => jov2viovv0tlz22wwy2svtunb2sm5x4o [amount] => [currency] => PLN [description] => platnosc dla Jan Kowalski [control] => [language] => pl [channel_id] => [ch_lock] => [onlinetransfer] => [redirection_type] => 0 [url] => [urlc] => [expiration_datetime] => [payer] => stdclass Object Strona 29 /61

30 Strona 30 / 61 [first_name] => John [last_name] => Smith [ ] => j.smith@example.com [phone] => [address] => stdclass Object [street] => Warszawska [building_number] => 1 [flat_number] => [postcode] => [city] => Krakow [region] => [country] => POL [recipient] => stdclass Object [account_number] => [company] => [first_name] => [last_name] => [address] => stdclass Object [street] => [building_number] => [flat_number] => [postcode] => [city] =>

31 accounts/int: account_id/payment_links/string: token/ szczegóły linku płatniczego Zasób zwraca szczegóły danego linku płatniczego. przykładowe żądanie: Strona 31 /61 nagłówki żądania: GET /test_seller/api/accounts/443005/payment_links/3drilk63fknyko778yziran6yx603xvo/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, PUT, PATCH, DELETE, HEAD, OPTIONS "href": " payment_links/3drilk63fknyko778yziran6yx603xvo/", "payment_url": " "token": "3drilk63fknyko778yziran6yx603xvo", "amount": "99.11", "currency": "PLN", "description": "Payment for order", "control": "202cb962ac59075b964b07152d234b70", "language": "pl", "channel_id": 4, "ch_lock": true, "onlinetransfer": true, "redirection_type": 0, "url": " "urlc": " "expiration_datetime": " T16:48:00", "payer": "first_name": "John", "last_name": "Smith", " ": "phone": " ", "address": "street": "Wielicka", "building_number": "72", "flat_number": null, "postcode": "30-552", "city": "Krakow", "region": "Malopolska", "country": "POL", "recipient": "account_number": "PL ", "company": "PJ Shop",

32 Strona 32 / 61 "first_name": "Patrick", "last_name": "Jones", "address": "street": "Marszalkowska", "building_number": "100", "flat_number": null, "postcode": "00-576", "city": "Warszawa" Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 200 OK ok 404 Not Found nie znaleziono sklepu Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/accounts/443005/payment_links/3drilk63fknyko778yziran6yx603xvo/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?> HTTP status code: stdclass Object [href] =>

33 payment_links/3drilk63fknyko778yziran6yx603xvo/ [payment_url] => [token] => 3drilk63fknyko778yziran6yx603xvo [amount] => [currency] => PLN [description] => Payment for order [control] => 202cb962ac59075b964b07152d234b70 [language] => pl [channel_id] => 4 [ch_lock] => 1 [onlinetransfer] => 1 [redirection_type] => 0 [url] => [urlc] => [expiration_datetime] => T16:48:00 [payer] => stdclass Object [first_name] => John [last_name] => Smith [ ] => john.smith@example.com [phone] => [address] => stdclass Object [street] => Wielicka [building_number] => 72 [flat_number] => [postcode] => [city] => Krakow [region] => Malopolska [country] => POL [recipient] => stdclass Object [account_number] => PL [company] => PJ Shop [first_name] => Patrick [last_name] => Jones [address] => stdclass Object [street] => Marszalkowska [building_number] => 100 [flat_number] => [postcode] => [city] => Warszawa Strona 33 /61

34 accounts/int: account_id/payout/ wypłata środków z salda sklepu ID Strona 34 / 61 Zasób pozwala zlecić wypłatę środków z salda danego sklepu ID. Wykonanie żądania powoduje powstanie operacji typu payout_any_amount dla każdego obiektu tablicy transfers. Jeśli w żądaniu nie zostanie przesłany numer rachunku do wypłaty account_number, to dla powstałej operacji zostanie przypisany domyślny numer rachunku określony w konfiguracji sklepu, w panelu administracyjnym. przykładowe żądanie: nagłówki żądania: POST /test_seller/api/accounts/443005/payout/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== żądanie: "currency": "PLN", "transfers": [ "amount": "19.30", "control": "019e1921bfb d1e", "description": "payout for JS", "recipient": "account_number": "PL ", "name": "John Smith", "amount": "56.20", "control": " ", "description": "payout for PJ", "recipient": "account_number": "PL ", "name": "Patrick Jones" ] nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: POST, OPTIONS "detail": "ok"

35 Znaczenie zwracanych kodów odpowiedzi HTTP: Strona 35 /61 HTTP status code OPIS 200 OK ok 403 Forbidden brak uprawnień 404 Not Found nie znaleziono sklepu Znaczenie własności przesyłanych w żądaniu: WŁASNOŚĆ TYP ZNACZENIE / OPIS currency string waluta w jakiej dokonywane są wypłaty format: ISO 4217 transfers.amount decimal kwota wypłacanych środków transfers.control string identyfikator operacji transfers.description string opis wypłaty transfers.recipient.account_number string numer konta bankowego, na który zostaną wypłacone środki format: IBAN transfers.recipient.name string nazwa odbiorcy przelewu Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $fields = array 'currency' => 'PLN', 'transfers' => array array 'amount' => '19.30', 'control' => '019e1921bfb d1e', 'description' => 'payout for JS', 'recipient' => array 'account_number' => 'PL ', 'name' => 'John Smith',,

36 Strona 36 / 61 ; array 'amount' => '56.20', 'control' => ' ', 'description' => 'payout for PJ', 'recipient' => array 'account_number' => 'PL ', 'name' => 'Patrick Jones', $data=json_encode$fields; $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," accounts/443005/payout/"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; curl_setopt $ch, CURLOPT_POST, 1; curl_setopt $ch, CURLOPT_POSTFIELDS, $data; curl_setopt $ch, CURLOPT_HTTPHEADER, array '', 'Content-Length: '.strlen$data; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?> HTTP status code: stdclass Object [detail] => ok

37 V. 2. operations/ lista operacji Zasób zwraca listę operacji utworzonych we wszystkich sklepach ID, do których dany użytkownik ma uprawnienia. Strona 37 /61 przykładowe żądanie: nagłówki żądania: GET /test_seller/api/operations/?type=payment&status=completed HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, HEAD, OPTIONS fragment odpowiedzi: "count": 283, "next": " "previous": null, "results": [ "href": " "number": "M ", "creation_datetime": " T13:16: ", "type": "payment", "status": "completed", "amount": "156.00", "currency": "PLN", "original_amount": "156.00", "original_currency": "PLN", "account_id": "443005", "related_operation": null, "description": "Order ", "control": "", "payer": "first_name": "Patrick", "last_name": "Jones", " ": "p.jones@example.com", "href": " "number": "M ", "creation_datetime": " T13:14: ", "type": "payment", "status": "completed", "amount": "835.00", "currency": "PLN", "original_amount": "835.00", "original_currency": "PLN", "account_id": "443005",

38 Strona 38 / 61 "related_operation": null, "description": "payment for A shop", "control": "", "payer": "first_name": "John", "last_name": "Smith", " ": "john.smith@example.com", Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 200 OK ok Znaczenie parametrów możliwych do przesyłania w żądaniu w celu filtrowania odpowiedzi: WŁASNOŚĆ TYP ZNACZENIE / OPIS account_id int numer sklepu ID type typ operacji dostępne wartości: payment payment_multimerchant_child payout refund complaint release_rollback status status operacji dostępne wartości: new processing completed rejected processing_realization_waiting processing_realization creation_date_from od daty utworzenia operacji format: YYYY-MM-DD creation_date_to do daty utworzenia operacji format: YYYY-MM-DD

39 description string opis bądź jego fragment operacji control string parametr kontrolny bądź jego fragment operacji Strona 39 /61 Znaczenie własności zwracanych w odpowiedzi, w tablicy results: WŁASNOŚĆ TYP ZNACZENIE / OPIS href string adres API, pod którym znajdują się szczegóły danej operacji number string numer operacji creation_datetime string data utworzenia type string typ operacji format: ISO 8601 RFC 3339 status string status operacji amount decimal kwota zaksięgowanej operacji currency string waluta zaksięgowanej operacji format: ISO 4217 original_amount decimal oryginalna kwota przesłana w zleceniu płatności original_currency string waluta kwoty przesłanej w zleceniu płatności format: ISO 4217 account_id int numer sklepu ID related_operation string operacja powiązana np. zwrot, jeśli takowa istnieje description string opis operacji control string parametr kontrolny operacji przesłany przez serwis Sprzedawcy w zleceniu płatności payer.first_name string imię osoby dokonującej płatność payer.last_name string nazwisko osoby dokonującej płatność payer. string osoby dokonującej płatność

40 Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. Strona 40 / 61 żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/operations/?type=payment&status=completed"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?> fragment odpowiedzi: HTTP status code: stdclass Object [count] => 283 [next] => operations/?page=2&status=completed&type=payment [previous] => [results] => Array [0] => stdclass Object [href] => [number] => M [creation_datetime] => T13:16: [type] => payment [status] => completed [amount] => [currency] => PLN [original_amount] => [original_currency] => PLN [account_id] => [related_operation] => [description] => Order [control] => [payer] => stdclass Object [first_name] => Patrick [last_name] => Jones [ ] => p.jones@example.com

41 [1] => stdclass Object [href] => [number] => M [creation_datetime] => T13:14: [type] => payment [status] => completed [amount] => [currency] => PLN [original_amount] => [original_currency] => PLN [account_id] => [related_operation] => [description] => payment for A shop [control] => [payer] => stdclass Object [first_name] => John [last_name] => Smith [ ] => john.smith@example.com Strona 41 /61

42 operations/string: operation_number/ szczegóły pojedynczej operacji Strona 42 / 61 Zasób zwraca szczegóły danej operacji. przykładowe żądanie: nagłówki żądania: GET /test_seller/api/operations/m / HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, HEAD, OPTIONS "href": " "number": "M ", "creation_datetime": " T13:16: ", "type": "payment", "status": "completed", "amount": "156.00", "currency": "PLN", "original_amount": "156.00", "original_currency": "PLN", "account_id": "443005", "related_operation": null, "description": "Order ", "control": "", "payer": "first_name": "Patrick", "last_name": "Jones", " ": "p.jones@example.com", "payment_method": "channel_id": 4 Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 200 OK ok 404 Not Found nie znaleziono operacji

43 Własności zwrócone w odpowiedzi zostały opisane w rozdziale operations/ lista operacji powyżej, natomiast poniżej zostały wymienione dodatkowe / opcjonalne własności jakie mogą wystąpić w zależności od konfiguracji sklepu ID: Strona 43 /61 WŁASNOŚĆ TYP ZNACZENIE / OPIS payment_method.channel_id int numer kanału, jakim została wykonana płatność payment_method.payer_bank_account.name string nazwa nadawcy przelewu payment_method.payer_bank_account.number string numer rachunku bankowego z jakiego została dokonana płatność payment_method.credit_card.issuer_identification_number string format: IBAN numer identyfikacyjny emitenta karty płatniczej payment_method.credit_card.brand string marka karty płatniczej Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/operations/m /"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?>

44 Strona 44 / 61 HTTP status code: stdclass Object [href] => [number] => M [creation_datetime] => T13:16: [type] => payment [status] => completed [amount] => [currency] => PLN [original_amount] => [original_currency] => PLN [account_id] => [related_operation] => [description] => Order [control] => [payer] => stdclass Object [first_name] => Patrick [last_name] => Jones [ ] => p.jones@example.com [payment_method] => stdclass Object [channel_id] => 4

45 operations/string: operation_number/operations/ payout lista operacji zawartych w operacji Zasób zwraca listę operacji zawartych w operacji typu payout wypłata. Strona 45 /61 przykładowe żądanie: nagłówki żądania: GET /test_seller/api/operations/m /operations/ HTTP/1.1 Host: ssl.dotpay.pl Accept: application/json Authorization: Basic dxnlcju4ndc6qvfnqwjxzef2qg== nagłówki odpowiedzi: HTTP/ OK Vary: Accept Allow: GET, HEAD, OPTIONS fragment odpowiedzi: "count": 54, "next": null, "previous": null, "results": [ "href": " "number": "M ", "creation_datetime": " T06:55: ", "type": "payment", "status": "completed", "amount": "1.00", "currency": "PLN", "original_amount": "1.00", "original_currency": "PLN", "account_id": "443005", "related_operation": null, "description": "test", "control": "", "payer": "first_name": "Jan", "last_name": "Kowalski", " ": "jan.kowalski@example.com", "href": " "number": "M ", "creation_datetime": " T10:13: ", "type": "refund", "status": "processing_realization_waiting", "amount": "238.00", "currency": "PLN", "original_amount": "238.00", "original_currency": "PLN", "account_id": "443005",

46 Strona 46 / 61 "related_operation": " "description": "Zwrot: payment for A shop", "control": null, "payer": null, Znaczenie zwracanych kodów odpowiedzi HTTP: HTTP status code OPIS 200 OK ok 404 Not Found nie znaleziono operacji Własności zwrócone w odpowiedzi zostały opisane w rozdziale operations/ lista operacji powyżej Poniżej został zamieszczony przykład żądania oraz odpowiedzi wykorzystujący język PHP oraz bibliotekę curl. żądanie: <?php $ch = curl_init ; curl_setopt $ch, CURLOPT_URL," api/operations/?type=payment&status=completed"; curl_setopt $ch, CURLOPT_SSL_VERIFYPEER, TRUE; curl_setopt $ch, CURLOPT_SSL_VERIFYHOST, 2; curl_setopt $ch, CURLOPT_CAINFO, "ca-bundle.crt"; // curl_setopt $ch, CURLOPT_FOLLOWLOCATION, 1; curl_setopt $ch, CURLOPT_RETURNTRANSFER, 1; curl_setopt $ch, CURLOPT_TIMEOUT, 100; curl_setopt $ch, CURLOPT_USERPWD, 'user:password'; $response = curl_exec $ch; // API response $curl_info = curl_getinfo$ch; //curl info curl_close $ch; echo '<pre>'; echo 'HTTP status code: '.$curl_info[http_code]; echo PHP_EOL.' '.PHP_EOL.PHP_EOL; print_rjson_decode$response; echo '</pre>';?> fragment odpowiedzi: HTTP status code: stdclass Object [count] => 54 [next] =>