{"components":{"schemas":{"authorize_partner_request":{"properties":{"key":{"description":"Parametr key dla odpowiedniego środowiska (produkcyjnego lub testowego) otrzymany od PragmaGO w procesie integracji","example":"partner_key","type":"string"},"secret":{"description":"Parametr secret dla odpowiedniego środowiska (produkcyjnego lub testowego) otrzymany od PragmaGO w procesie integracji","example":"partner_secret","type":"string"}},"required":["secret","key"],"type":"object"},"authorize_partner_response":{"properties":{"refresh_token":{"example":"25cd7f17e733f344d8b2d19fb6559f7b0fea72c1c9b3986f8cefa9af8c25851a6d48ed6da1d92483ae3ff1eb401373c51daeab12125559e127e6ed99040a8ac2","type":"string"},"token":{"example":"eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpYXQiOjE3MDczMjAwNjAsImV4cCI6MTcwNzMyMDY2MCwicm9sZXMiOlsiUk9MRV9BQ0NFU1NfUEFSVE5FUiJdLCJ1c2VybmFtZSI6ImQ1ZTQ5MDk4LWRkZTEtNGFlZS04NWQ3LTYyZTFlNmJjMTRlNyJ9.YOvIpJDN3DyLSLBG4kcp5gdjElucBdlyVdnuZzw0lWzSPVQlzPKJLoQqzqsE69i-25eiSuPQXf6XC_nuzeT2b9_-DBL7YJORtwug7Cnff-b1u7thiQL50B5XgDAfT9a2BP_5_qJQlTDfTBK8JkU1kLgvfgp36W-5qY7a1mUiZj8oUlBDO8yumkrTd526DCn1unwSqdEijpG8DqFHHGt1VCocebTuRd850Bpd-uDDp6vGHx7LQB9ta-HbHnI7rqmxZjacKxagda7LfS5YELNYD8GvFRIuDJG3yFtPzxCuAolQ2WcZ58lurTZCeRfxY0557QOlKAGMrNFrQZ-iN3mnEmRGdy7Wgs3h2XAg7KqzqSp2J5mAofNG5S8LA7HSrloHwYR8nO-1gj2Qf6m-84j2clqCBDNwUB3ROgnq8Fwm6OhiMtjsfRHyGurslexmjMeM8iJC1thV3dub3hX2X_OoVyNUCsiCLHhR5dALEjj26JUvkB361DFeibgmMl_4mVgavFj-Hjr911OPfZqKr7_3r_3FcsOkZx5JwLjNTWGgSanWTubKNBp5xwD6dpNWRIXBHuL78v0ATFiwekV9SJNiNntUums4SlYGol0YUUybZAzKUJz0hD0TrbO4ZFAgacoQnt1mmGfH6lNkCsRucumkZJ4cMmQp6FhNb0jyk0m8nCk","type":"string"}},"type":"object"},"bank_account":{"description":"Dane do przelewu. W przypadku VATowców musi być to rachunek bankowy na białej liście należący do NIP-u przesłanego w obiekcie <b>payee</b> w polu <b>registrationNumber</b>. To, czy dany rachunek bankowy figuruje na białej liście, można sprawdzić w serwisie <a href=\"https://www.podatki.gov.pl/wykaz-podatnikow-vat-wyszukiwarka\" target=\"_blank\">Wykaz podatników VAT - wyszukiwarka</a>","properties":{"iban":{"description":"Numer IBAN na jaki zostaną przesłane środki. \nZgodne z powszechnie przyjętym formatem IBAN.","example":"PL73601061874719764859322259","type":"string"},"swift":{"description":"Numer SWIFT banku, do którego należy powyższy numer IBAN.\n\nWymagany dla rachunków bankowych w innej walucie niż PLN.","example":"BPKOPLPW","type":"string"}},"required":["iban"],"type":"object"},"loan_calculate_response":{"properties":{"amountToBeRepaid":{"properties":{"amount":{"description":"Wartość wyrażona w groszach tj. 914,58 zł = 91458","example":91458,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"type":"object"},"financingCost":{"properties":{"amount":{"description":"Wartość wyrażona w groszach tj. 124,12 zł = 12412","example":12412,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"type":"object"},"installmentAmount":{"properties":{"amount":{"description":"Wartość wyrażona w groszach tj. 124,12 zł = 12412","example":12412,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"type":"object"}},"type":"object"},"loan_create_payment_request":{"properties":{"cancelUrl":{"description":"Adres powrotu przy ścieżkach negatywnych.\n\nNa ten adres zostanie przekierowany Klient, gdy Klient anuluje płatność PragmaPay lub PragmaGO nie opłaci zamówienia. Zazwyczaj jest to link do wyboru innej metody płatności. \n\nW przypadku braku przesłania, Klient zostanie przekierowany na returnUrl.","example":"https://cancel.com","type":"string"},"customer":{"description":"Dane Klienta, który wybrał metodę płatności PragmaPay. \nCzym więcej danych zostanie przesłanych tym proces dla Klienta jest krótszy i tym wyższa jest konwersja.","properties":{"email":{"description":"Adres e-mail Klienta. \n\nPrzy JDG powinien to być adres e-mail właściciela firmy, a przy spółce osoby upoważnionej.","example":"test@email.pl","pattern":"^[A-Z0-9][A-Z0-9._%+-]+@(?:[A-Z0-9-]+\\.)+[A-Z]{2,}$","type":"string"},"firstName":{"description":"Imię Klienta. \n\nPrzy JDG powinno być to imię właściciela firmy, a przy spółce osoby upoważnionej.","example":"Jan","maxLength":32,"minLength":2,"type":"string"},"lastName":{"description":"Nazwisko Klienta. \n\nPrzy JDG powinno być to nazwisko właściciela firmy, a przy spółce osoby upoważnionej.","example":"Kowalski","maxLength":64,"minLength":2,"type":"string"},"identificationNumber":{"description":"Poprawny format numeru PESEL (w przypadku firm z Polski). \nMożna przesłać zarówno dla JDG jak i spółki. Natomiast przy JDG musi być to PESEL właściciela, w przeciwnym przypadku firma otrzyma decyzję negatywną.","example":"pesel","type":"string"},"identityDocument":{"description":"Poprawny numer i seria dowodu osobistego \nMożna przesłać zarówno dla JDG jak i spółki. Natomiast przy JDG musi być to dokument właściciela, w przeciwnym przypadku firma otrzyma decyzję negatywną.","properties":{"number":{"description":"Numer i seria dowodu osobistego","example":"ZZC108201","type":"string"},"type":{"description":"Typ dokumentu tożsamości","example":"idCard","type":"string"}},"required":["type","number"],"type":"object"},"phone":{"description":"Numer telefonu Klienta. \n\nPrzy JDG powinien to być numer właściciela firmy, a przy spółce osoby upoważnionej.","properties":{"number":{"description":"Numer","example":"677686908","maxLength":15,"minLength":9,"type":"string"},"prefix":{"description":"Kod kraju","example":"+48","type":"string"}},"required":["number","prefix"],"type":"object"},"registrationNumber":{"description":"Jest to NIP Klienta, który wybrał metodę płatności PragmaPay.\n\nMusi być to prawdziwy NIP istniejący przynajmniej w jednej z baz zewnętrznych typu: CEIDG, GUS. Oznacza to, że obecnie finansowanie udzielane jest jedynie firmom z Polski.","properties":{"country":{"description":"Kod kraju zgodnie z ISO, np. PL, DE itp. Domyślnie: PL","example":"PL","maxLength":2,"minLength":2,"type":"string"},"registrationNumber":{"description":"Numer rejestracyjny Klienta (NIP istniejący przynajmniej w jednej z baz zewnętrznych typu: CEIDG, GUS).","example":"PL6342427710","type":"string"}},"required":["country","registrationNumber"],"type":"object"}},"required":["registrationNumber","phone","email"],"type":"object"},"items":{"description":"Tablica obiektów zamówień, które dany Klient chce jednocześnie opłacić. Każdy element w tablicy odpowiada finansowaniu zamówień złożonych przez Klienta u <b>jednego</b> Sprzedawcy. Przykładowo, jeśli Klient złożył zamówienie u dwóch Sprzedawców i ma ono zostać opłacone za pośrednictwem jednego żądania, to w tablicy należy przesłać dwa obiekty, z który każdy odpowiada osobnemu Sprzedawcy i jego parametrom (NIP, rachunek bankowy, wartość zamówienia itp.). Elementy tablicy items <b>nie odpowiadają</b> pojedynczym produktom z koszyka Klienta.","items":{"properties":{"bankTransferDetails":{"description":"Dane do przelewu, w tym odbiorca przelewu, tytuł przelewu i rachunek bankowy, na jaki PragmaGO ma przesłać środki.","properties":{"payee":{"description":"Dane firmy, odbiorcy płatności. Tej firmie PragmaGO prześle środki.","properties":{"email":{"description":"Adres e-mail odbiorcy płatności.","example":"test@email.pl","pattern":"^[A-Z0-9][A-Z0-9._%+-]+@(?:[A-Z0-9-]+\\.)+[A-Z]{2,}$","type":"string"},"phone":{"$ref":"#/components/schemas/phone_with_prefix"},"registrationNumber":{"description":"Obiekt numeru rejestracyjnego (Numer NIP wraz z kodem kraju).","properties":{"country":{"description":"Kod kraju zgodnie z ISO, np. PL, DE itp. Domyślnie: PL","example":"PL","maxLength":2,"minLength":2,"type":"string"},"registrationNumber":{"description":"Numer rejestracyjny odbiorcy płatnosci (NIP istniejący przynajmniej w jednej z baz zewnętrznych typu: CEIDG, GUS).","example":"PL6342427710","type":"string"}},"required":["country","registrationNumber"],"type":"object"}},"required":["registrationNumber"],"type":"object"},"payeeBankAccount":{"$ref":"#/components/schemas/bank_account"},"transferTitle":{"description":"Tytuł przelewu, który zostanie podany w przypadku wysłania środków za dane zamówienie. \nMaksymalnie 128 znaków w przypadku tradycyjnego przelewu. \nW przypadku możliwości realizacji przelewu Split Payment maksymalnie 33 znaki. \n\nJeśli tytuł przelewu nie zostanie podany, wszystkie przelewy są przetwarzane grupowo, następnego dnia roboczego od daty sfinansowania zamówienia. Oznacza to, że wszystkie zamówienia sfinansowane w danym dniu przez PragmaGO zostaną przekazane do odbiorcy przelewu za pomocą jednej transakcji, chyba że ustalono inaczej. \n\nW przypadku finansowania w piątek, sobotę i niedzielę, odbiorca przelewu otrzyma łącznie trzy przelewy w poniedziałek. Ta sama zasada dotyczy dni świątecznych. \n\nTakie środki przesyłane są z tytułem przelewu:\n<span style=\"color: #36B37E\">Wypłata środków za RRRR-MM-DD</span>, \ngdzie RRRR-MM-DD, to data finansowania \n\nPrzykład: \n<span style=\"color: #36B37E\">Wypłata środków za 2024-03-15</span>","example":"Wypłata środków za 2024-03-15","type":"string"}},"required":["payee","payeeBankAccount"],"type":"object"},"invoice":{"description":"Przesyłany, gdy faktura wybrana do opłacenia metodą płatności PragmaPay, jest wystawiona. \nPrzesyłanie pola jest niezbędne w przypadku umożliwienia realizacji przelewów za pomocą Split Payment.","properties":{"dueDate":{"description":"Termin płatności faktury \nPoprawna data w formacie YYYY-MM-DD lub null","example":"2020-10-20","format":"date","type":"string"},"grossValue":{"description":"Wartość faktury jaką dany Klient chce opłacić za pomocą PragmaPay (Brutto).","properties":{"amount":{"description":"Wartość wyrażona w groszach tj. 1 000 zł = 100000","example":50000,"maximum":100000000000,"minimum":10000,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"required":["amount","currency"],"type":"object"},"invoiceNumber":{"description":"Numer faktury \n\t\nPole jest warunkowo wymagane. Oznacza to, że jest wymagane tylko przy przesłaniu pola Split Payment na true (czyli, gdy mamy to wypłacić mechanizmem podzielonej płatności). Ale z możliwością przesłania nawet gdy Split Payment będzie null lub false.","example":"FV05/2016/0001","maxLength":35,"minLength":1,"type":"string"},"isSplitPayment":{"description":"Czy zastosować mechanizm dzielonej płatności \n\t\nMechanizm dzielonej płatności\n\nJeśli Partner prześle nie (lub zaznaczy to u siebie w Strefie Partnera), to Klient nie widzi opcji płatności mechanizmem podzielonej płatności. \n\n1. jest możliwość przesłania true, jeśli waluta finansowania (pole value) to PLN\n2. należy przesłać true, jeśli przelew od PragmaGO ma być wysłany w Split Payment. Podanie wartości netto i numeru faktury jest wtedy wymagane.\n 3. należy przesłać false, jeśli przelew od PragmaGO nie może być wysłany w Split Payment i Klient nie zobaczy tej opcji. Wartość netto i numer faktury nie są wymagane, ale można je przesłać.\n 4. w przypadku nie przesłania żadnej wartości, Klient o płatności mechanizmem podzielonej płatności decyduje na formularzu. Wartość netto i numer faktury nie są wymagalne, ale jeśli Partner obu nie prześle, to Klient nie będzie mógł wybrać tej opcji.","example":false,"type":"boolean"},"merchant":{"description":"Dane Sprzedawcy, Dostawcy zamówienia lub usługi.\nW przypadku braku istnienia firmy w zewnętrznych bazach danych typu CEIDG/GUS  płatność może nie zostać zrealizowana.","properties":{"email":{"description":"Adres e-mail merchanta, sprzedającego, czy inaczej firmy, która wystawi fakturę za daną usługę, czy towar","example":"test@abcdefghij.pl","pattern":"^[A-Z0-9][A-Z0-9._%+-]+@(?:[A-Z0-9-]+\\.)+[A-Z]{2,}$","type":"string"},"phone":{"$ref":"#/components/schemas/phone_with_prefix"},"registrationNumber":{"$ref":"#/components/schemas/registration_number"},"storeUrl":{"description":"Adres www sklepu merchanta","example":"http://storeUrl.com","type":"string"}},"required":["registrationNumber"],"type":"object"},"netValue":{"description":"Wartość Netto (Przesłanie pola jest wymagane przy przesłaniu pola isSplitPayment na true) \nnetValue <= grossValue \nWaluta taka sama jak wartości brutto.","properties":{"amount":{"description":"Wartość wyrażona w groszach tj. 1 000 zł = 100000","example":50000,"minimum":0,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["grossValue","merchant"],"type":"object"},"merchant":{"description":"Dane Sprzedawcy, Dostawcy zamówienia lub usługi.\nW przypadku braku istnienia firmy w zewnętrznych bazach danych typu CEIDG/GUS  płatność może nie zostać zrealizowana\n\nPola nie należy przesyłać, jeśli został przesłany obiekt: Obiekt - faktura.","properties":{"email":{"description":"Adres e-mail merchanta, sprzedającego, czy inaczej firmy, która wystawi fakturę za daną usługę, czy towar","example":"test@abcdefghij.pl","pattern":"^[A-Z0-9][A-Z0-9._%+-]+@(?:[A-Z0-9-]+\\.)+[A-Z]{2,}$","type":"string"},"phone":{"$ref":"#/components/schemas/phone_with_prefix"},"registrationNumber":{"$ref":"#/components/schemas/registration_number"},"storeUrl":{"description":"Adres www sklepu merchanta","example":"http://storeUrl.com","type":"string"}},"required":["registrationNumber"],"type":"object"},"partnerItemId":{"description":"Id zamówienia lub faktury jaką dany klient chce opłacić za pomocą PragmaPay","example":"043cace6-804d-4695-822c-e7a6b5d7c967","format":"uuid","maxLength":255,"type":"string"},"value":{"description":"Wartość zamówienia, którą klient chce uregulować poprzez metodę płatności PragmaPay.\n\nPola nie należy przesyłać, jeśli został przesłany obiekt: Obiekt - faktura.","properties":{"amount":{"description":"Wartość wyrażona w groszach tj. 1 000 zł = 100000","example":50000,"maximum":100000000000,"minimum":10000,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["value","bankTransferDetails"],"type":"object"},"type":"array"},"transactionData":{"description":"Dane transakcyjne danego Klienta. Mają na celu zwiększyć dopasowanie limitu finansowania.","properties":{"identifier":{"description":"Informacja względem jakiego obiektu (np. NIP/email) dane finansowe zostały skompletowane. Jeśli dane należą do danej Firmy (czyli NIPu) to nie trzeba nic przesyłać. Jeśli dane należą do adresu email to należy przesłać do jakiego adresu email.","type":"object","properties":{"email":{"description":"Należy przesłać, jeśli dane transakcyjne są powiązane z danym adresem email i nie mają powiązania do NIPu.","example":"kasia@nowak.pl","pattern":"^[A-Z0-9][A-Z0-9._%+-]+@(?:[A-Z0-9-]+\\.)+[A-Z]{2,}$","type":"string"}}},"data":{"description":"Dane transakcyjne","type":"object","properties":{"monthlyReports":{"description":"Historia transakcji z ostatnich 12 zamkniętych/pełnych miesięcy danego Klienta.","type":"array","items":{"properties":{"month":{"description":"Miesiąc za który są przesyłane dane finansowe Klienta.","type":"string","format":"date","example":"2024-02-01"},"transactionsValue":{"description":"Wartość transakcji brutto danego Klienta w PLN z danego okresu. Na przykład łączna kwota zakupów. Należy przesłać wartość wyrażoną w groszach tj. 1 000 zł = 100000","type":"integer","example":32},"transactionsCount":{"description":"Łączna liczba transakcji danego Klienta w danym okresie (nie uwzględnia zwrotów).","type":"integer","example":32},"refundsValue":{"description":"Wartość zwrotów danego Klienta w PLN z danego okresu. Należy przesłać wartość wyrażoną w groszach tj. 1 000 zł = 100000 \n\nJeśli informacja o wartości zwrotów nie będzie przesyłana, to w tym polu należy przesyłać wartość 0","type":"integer","example":32},"refundsNumber":{"description":"Liczba zwrotów danego Klienta w danym okresie. \n\nJeśli informacja o liczbie zwrotów nie będzie przesyłana, to w tym polu należy przesyłać wartość 0","type":"integer","example":32},"transactionsLow":{"description":"Najniższa kwota transakcji sprzedaży/obrotu w zł w danym okresie. Należy przesłać wartość wyrażoną w groszach tj. 1 000 zł = 100000","type":"integer","example":32},"transactionsHigh":{"description":"Najwyższa kwota transakcji sprzedaży/obrotu w zł w danym okresie. Należy przesłać wartość wyrażoną w groszach tj. 1 000 zł = 100000","type":"integer","example":32},"pointsOfSale":{"description":"Liczba urządzeń danej firmy w danym miesiącu","type":"integer","example":32}},"required":["month","transactionsValue","transactionsCount","refundsValue","refundsNumber"],"type":"object"}},"contractDate":{"description":"Data zawarcia umowy o współpracę danej firmy z Partnerem.","format":"date","type":"string","example":"2020-10-10"},"firstTransactionDate":{"description":"Data pierwszej transakcji firmy u Partnera.","format":"date","type":"string","example":"2020-10-10"}},"required":["monthlyReports"]}},"type":"object","required":["data"]},"notificationUrl":{"description":"Adres do notyfikacji, na który przesłane zostaną powiadomienia o zmianach dotyczących płatności PragmaPay. Do każdej płatności może być inny adres.","example":"https://notify.com","type":"string"},"partnerOrderId":{"description":"Unikalne ID zamówienia po stronie Partnera. Nie może być dwóch zamówień po stronie Partnera z tym samym ID.\nW przypadku grupy zamówień opłacanych za pomocą jednej płatności przy wielu Sprzedających, ID płatności, inaczej ID grupy zamówień u Klienta (np. koszyk zakupów z wieloma dostawcami).","example":"d2e91a20-23e4-4fc3-b79d-2b27a0afdce5","format":"uuid","type":"string"},"repaymentPeriod":{"description":"Taki okres spłaty ustawi się Klientowi domyślnie. \nKlient ma możliwość zmiany okresu spłaty po przejściu na proces po stronie PragmaGO.","properties":{"type":{"description":"Typ spłaty - odroczenie płatności lub rozłożenie na raty. Możliwe wartości to: DAYS, INSTALLMENTS","type":"string","example":"DAYS"},"value":{"description":"Wartość liczbowa korespondująca z typem (liczba dni lub rat). Wartości indywidualnie ustalane z partnerem. Domyślnie: \nINSTALLMENTS: 3, 6, 9 i 12 \nDAYS: 14,30,60","type":"integer","example":60}},"required":["type","value"],"type":"object"},"availableRepaymentPeriods":{"description":"Są to okresy spłat, które Klient może wybrać w procesie PragmaPay. Okresy spłat muszą zawierać się w tych dostępnych u danego Partnera.\nPrzykład: \nPartner ma dostępne okresy spłat 14, 30, 60 dni oraz 3, 6, 9 i 12 rat. Partner przesyła po API, że w tym wniosku Klient ma dostępne tylko rozłożenie na raty, więc Klient będzie mógł płatność rozłożyć jedynie na raty, nie będzie widział opcji odroczenia płatności. W przypadku, gdy Partner prześle po API jeden okres spłaty np. 14 dni, Klient nie ma w ogóle możliwości zmiany okresu spłaty.","type":"array","items":{"type":"object","properties":{"value":{"type":"integer","example":3},"type":{"type":"string","enum":["INSTALLMENTS","DAYS"],"example":"INSTALLMENTS"}},"required":["value","type"]}},"returnUrl":{"description":"Domyślny adres powrotu (do Partnera/Sklepu etc).\n\nNa ten adres zostanie przekierowany Klient po opłaceniu zamówienia metodą PragmaPay.","example":"https://return.com","type":"string"},"maxPaymentTime":{"description":"Czas, po którym płatność zostanie automatycznie odrzucona. Domyślna wartość to 24h.\n\nMinimalny czas ważności formularza to 1h, maksymalny to 168h.","example":15,"type":"integer"},"partnerCustomerId":{"description":"ID danej firmy u Partnera. Dzięki temu możemy od momentu złożenia wniosku powiązać daną firmę z jej dłuższą historią i przyznać jej bardziej dopasowaną ofertę.","example":"USER_84GHT56KJ9","type":"string"}},"required":["items","returnUrl","notificationUrl","customer","partnerOrderId","transactionData"],"type":"object"},"loan_create_payment_response":{"properties":{"URL":{"description":"URL niezbędny przy wariancie integracji z <b>przekierowaniem na formularz PragmaGO</b>. Na ten URL należy przekierować Klienta, po wyborze metody PragmaPay. \nURL jest odpowiednio do środowiska testowego lub produkcyjnego. Link do formularza PragmaGO domyślnie jest ważny przez 24h od wygenerowania. Po tym czasie wniosek jest automatycznie odrzucany. Istnieje możliwość wydłużenia czasu ważności formularza przy pomocy pola <i>maxPaymentTime</i> przesyłanego w żądaniu.","example":"business.pragmago.pl/pragma-pay/46985c85-bf5a-406e-92dc-31b696d04f0f","type":"string"},"items":{"items":{"properties":{"itemId":{"description":"Identyfikatory itemId dla każdego item wysłanego w tej akcji. Wykorzystywane, gdy przesłanych item będzie więcej niż jeden.","example":"ea68dba3-592c-4394-9af6-fb1e6adf3272","format":"uuid","type":"string"},"partnerItemId":{"example":"043cace6-804d-4695-822c-e7a6b5d7c967","format":"uuid","type":"string"}},"type":"object"},"type":"array"},"paymentId":{"description":"paymentId, który należy podać przy wariancie integracji z pop-up. Wykorzystywany jest również przy innych akcjach.","example":"8d76608d-c622-494b-8509-2b61b13ba6be","format":"uuid","type":"string"}},"type":"object"},"loan_get_payment_response":{"properties":{"items":{"items":{"properties":{"partnerItemId":{"description":"Id itemu po stronie Partnera (o ile zostało przesłane w akcji)","example":"043cace6-804d-4695-822c-e7a6b5d7c967","format":"uuid","type":"string"},"status":{"description":"Status płatności","enum":["NEW","FINANCED","REJECTED","WAITING","CANCELED"],"example":"FINANCED"},"value":{"description":"Wartość zamówienia lub faktury","properties":{"format":{"description":"Format wartości","example":"MINOR","type":"string"},"amount":{"description":"Wartość wyrażona w groszach tj. 1 000 zł = 100000","example":50000,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"required":["amount","currency"],"type":"object"}},"type":"object"},"type":"array"},"paymentId":{"description":"ID otrzymane wraz z kodem 2XX po wyzwoleniu akcji z wyborem metody płatności PragmaPay","example":"8d76608d-c622-494b-8509-2b61b13ba6be","format":"uuid","type":"string"},"repaymentPeriod":{"description":"Okres spłaty","properties":{"type":{"description":"Typ spłaty - odroczenie płatności lub rozłożenie na raty","enum":["DAYS","INSTALLMENTS"],"example":"DAYS","type":"string"},"value":{"description":"Wartość liczbowa korespondująca z typem (liczba dni lub rat). Wartości indywidualnie ustalane z partnerem. Domyślnie: \nINSTALLMENTS: 3, 6, 9 i 12 \nDAYS: 14,30,60","example":60,"type":"integer"}},"type":"object"}},"type":"object"},"loan_update_payment_request":{"properties":{"itemId":{"description":"Pole itemId otrzymane wraz z kodem 2XX po wyzwoleniu akcji z wyborem metody płatności PragmaPay \nWymagane w przypadku przesłania do zamówienia o identyfikatorze paymentId (podanym w url) więcej niż jednego item","example":"8d76608d-c622-494b-8509-2b61b13ba6be","format":"uuid","type":"string"},"partnerUpdateId":{"description":"Unikalne ID aktualizacji płatności po stronie Partnera. Nie ma możliwości wysłania tych samych ID zwrotu, nawet do dwóch różnych Klientów i zamówień.","example":"8d76608d-c622-494b-8509-2b61b13ba6be","format":"uuid","type":"string"},"value":{"description":"Wartość zwrotu \n Wartość większa od 0 i mniejsza lub równa wartości zamówienia pomniejszonej o sumę zwrotów dodanych do tego zamówienia","properties":{"amount":{"description":"Wartość wyrażona w groszach tj. 1 000 zł = 100000","example":50000,"type":"integer"},"currency":{"description":"Waluta \nDozwolone wartości to obecnie: PLN","example":"PLN","type":"string"}},"required":["amount","currency"],"type":"object"}},"required":["partnerUpdateId","value"],"type":"object"},"loan_update_payment_response":{"properties":{"bankAccount":{"description":"Rachunek bankowy, na który należy wykonać przelew ze zwrotem","example":"PL79879710262743745073301427","type":"string"},"id":{"description":"Unikalny identyfikator zwrotu","example":"8d76608d-c622-494b-8509-2b61b13ba6be","format":"uuid","type":"string"},"link":{"description":"Automatycznie generowany link do płatności. Można skorzystać z niego lub wykonać przelew ręcznie, podając pozostałe dane przesłane w odpowiedzi.","example":"https://pbl.pragmago.tech/pgo-1234","type":"string"},"title":{"description":"Tytuł, który należy podać w przelewie ze zwrotem","example":"pgo-1234","type":"string"},"validTill":{"description":"Termin ważności linku do przelewu","example":"2024-02-08 07:35:58","format":"date-time","type":"string"}},"type":"object"},"test_get_sms_token_response":{"properties":{"smsCode":{"example":"971202","type":"string"},"createdAt":{"example":"2024-04-15T14:23:46","format":"date-time","type":"string"}},"type":"object"},"merchant":{"description":"Dane Sprzedawcy, Dostawcy zamówienia lub usługi.\nW przypadku braku istnienia firmy w zewnętrznych bazach danych typu CEIDG/GUS  płatność może nie zostać zrealizowana\n\nPola nie należy przesyłać, jeśli został przesłany obiekt: Obiekt - faktura.","properties":{"email":{"description":"Adres e-mail merchanta, sprzedającego, czy inaczej firmy, która wystawi fakturę za daną usługę, czy towar","example":"test@abcdefghij.pl","pattern":"^[A-Z0-9][A-Z0-9._%+-]+@(?:[A-Z0-9-]+\\.)+[A-Z]{2,}$","type":"string"},"phone":{"$ref":"#/components/schemas/phone_with_prefix"},"registrationNumber":{"$ref":"#/components/schemas/registration_number"},"storeUrl":{"description":"Adres www sklepu merchanta","example":"http://storeUrl.com","type":"string"}},"required":["registrationNumber"],"type":"object"},"phone_with_prefix":{"description":"Numer telefonu w formacie międzynarodowym.","properties":{"number":{"description":"Numer","example":"677686908","maxLength":15,"minLength":9,"type":"string"},"prefix":{"description":"Kod kraju","example":"+48","type":"string"}},"required":["number","prefix"],"type":"object"},"refresh_token_request":{"properties":{"refresh_token":{"description":"Refresh token otrzymany w odpowiedzi akcji Autoryzacja","example":"25cd7f17e733f344d8b2d19fb6559f7b0fea72c1c9b3986f8cefa9af8c25851a6d48ed6da1d92483ae3ff1eb401373c51daeab12125559e127e6ed99040a8ac2","type":"string"}},"required":["refresh_token"],"type":"object"},"registration_number":{"description":"Obiekt numeru rejestracyjnego (Numer NIP wraz z kodem kraju).","properties":{"country":{"description":"Kod kraju zgodnie z ISO, np. PL, DE itp. Domyślnie: PL","example":"PL","maxLength":2,"minLength":2,"type":"string"},"registrationNumber":{"description":"Numer rejestracyjny Klienta (NIP istniejący przynajmniej w jednej z baz zewnętrznych typu: CEIDG, GUS).","example":"PL6342427710","type":"string"}},"required":["country","registrationNumber"],"type":"object"},"validation_errors":{"description":"Obiekt błędów walidacji","properties":{"code":{"description":"Kod błędu","example":400,"type":"integer"},"errors":{"description":"Lista błędów w formacie obiektów JSON","example":"{\"collection0type\": \"Tego pola brakuje.\"}","type":"string"},"message":{"description":"Wiadomość błędu","example":"Validation errors","type":"string"}},"type":"object"}},"examples":{"payment_gateway":{"summary":"Przykład dla bramek płatniczych","value":{"customer":{"email":"customer@example.com"},"items":[{"bankTransferDetails":{"payee":{"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"email":"payee@example.com","phone":{"number":"144 444 444 4","prefix":"+48"}},"payeeBankAccount":{"iban":"PL52102023130000380205581980","swift":"BPKOPLPW"}},"value":{"amount":50000,"currency":"PLN"},"merchant":{"registrationNumber":{"country":"PL","registrationNumber":"PL6342427710"}},"partnerItemId":"29b2ce4f-2f80-45da-b1f5-33194477becb"}],"transactionData":{"data":{"monthlyReports":[{"month":"2025-02-01","transactionsValue":32222,"transactionsCount":3,"refundsValue":0,"refundsNumber":0},{"month":"2025-01-01","transactionsValue":549999,"transactionsCount":1,"refundsValue":549999,"refundsNumber":1},{"month":"2024-12-01","transactionsValue":89999,"transactionsCount":2,"refundsValue":0,"refundsNumber":0},{"month":"2024-11-01","transactionsValue":800000,"transactionsCount":4,"refundsValue":1,"refundsNumber":20000},{"month":"2024-10-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-09-01","transactionsValue":49999,"transactionsCount":3,"refundsValue":49999,"refundsNumber":3},{"month":"2024-08-01","transactionsValue":99989,"transactionsCount":9,"refundsValue":0,"refundsNumber":0},{"month":"2024-07-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-06-01","transactionsValue":1340000,"transactionsCount":1,"refundsValue":0,"refundsNumber":0},{"month":"2024-05-01","transactionsValue":3222299,"transactionsCount":11,"refundsValue":300000,"refundsNumber":1},{"month":"2024-04-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-03-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0}],"firstTransactionDate":"2020-10-10"},"identifier":{"email":"customer@example.com"}},"notificationUrl":"https://example.com/notify","partnerOrderId":"e5d95044-fe0a-48cd-8fed-e602a511f824","returnUrl":"https://example.com/return","cancelUrl":"https://example.com/cancel","availableRepaymentPeriods":[{"value":3,"type":"INSTALLMENTS"},{"value":6,"type":"INSTALLMENTS"},{"value":9,"type":"INSTALLMENTS"},{"value":12,"type":"INSTALLMENTS"}]}},"marketplace":{"summary":"Przykład dla marketplace\n","value":{"customer":{"email":"customer@example.com","phone":{"number":"1444444444","prefix":"+48"},"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"firstName":"Jan","lastName":"Kowalski"},"items":[{"bankTransferDetails":{"payee":{"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"email":"payee@example.com","phone":{"number":"1444444444","prefix":"+48"}},"payeeBankAccount":{"iban":"PL52102023130000380205581980","swift":"BPKOPLPW"}},"value":{"amount":50000,"currency":"PLN"},"merchant":{"registrationNumber":{"country":"PL","registrationNumber":"PL6342427710"},"email":"payee@example.com","phone":{"number":"9444444444","prefix":"+48"}},"partnerItemId":"29b2ce4f-2f80-45da-b1f5-33194477becb"},{"bankTransferDetails":{"payee":{"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"email":"payee2@example.com","phone":{"number":"1444444444","prefix":"+48"}},"payeeBankAccount":{"iban":"PL52102023130000380205581980","swift":"BPKOPLPW"}},"value":{"amount":100000,"currency":"PLN"},"merchant":{"registrationNumber":{"country":"PL","registrationNumber":"PL6342427710"},"email":"payee2@example.com","phone":{"number":"9444444444","prefix":"+48"}},"partnerItemId":"60d78ee3-1df6-4bd5-a489-3bca2e4d9b8b"}],"transactionData":{"data":{"monthlyReports":[{"month":"2025-02-01","transactionsValue":32222,"transactionsCount":3,"refundsValue":0,"refundsNumber":0},{"month":"2025-01-01","transactionsValue":549999,"transactionsCount":1,"refundsValue":549999,"refundsNumber":1},{"month":"2024-12-01","transactionsValue":89999,"transactionsCount":2,"refundsValue":0,"refundsNumber":0},{"month":"2024-11-01","transactionsValue":800000,"transactionsCount":4,"refundsValue":1,"refundsNumber":20000},{"month":"2024-10-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-09-01","transactionsValue":49999,"transactionsCount":3,"refundsValue":49999,"refundsNumber":3},{"month":"2024-08-01","transactionsValue":99989,"transactionsCount":9,"refundsValue":0,"refundsNumber":0},{"month":"2024-07-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-06-01","transactionsValue":1340000,"transactionsCount":1,"refundsValue":0,"refundsNumber":0},{"month":"2024-05-01","transactionsValue":3222299,"transactionsCount":11,"refundsValue":300000,"refundsNumber":1},{"month":"2024-04-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-03-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0}],"firstTransactionDate":"2020-10-10"},"identifier":{"email":"customer@example.com"}},"notificationUrl":"https://example.com/notify","partnerOrderId":"85296193-40ae-4c04-a4ff-9839fcca8ff1","returnUrl":"https://example.com/return","cancelUrl":"https://example.com/cancel","repaymentPeriod":{"type":"DAYS","value":60}}},"partner_with_invoice_list_and_split_payment":{"summary":"Przykład dla Partnerów z listą faktur (płatność Split Payment)","value":{"customer":{"email":"customer@example.com","phone":{"number":"1444444444","prefix":"+48"},"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"firstName":"Jan","lastName":"Kowalski","identificationNumber":"85102204075"},"items":[{"bankTransferDetails":{"payee":{"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"email":"payee@example.com","phone":{"number":"1444444444","prefix":"+48"}},"payeeBankAccount":{"iban":"PL52102023130000380205581980","swift":"BPKOPLPW"},"transferTitle":"Wypłata środków za 2024-03-15"},"invoice":{"merchant":{"registrationNumber":{"country":"PL","registrationNumber":"PL6342427710"},"email":"merchant@example.com","phone":{"number":"9444444444","prefix":"+48"}},"grossValue":{"amount":50000,"currency":"PLN"},"netValue":{"amount":40000,"currency":"PLN"},"dueDate":"2024-03-15","invoiceNumber":"FV05/2024/0001","isSplitPayment":true},"partnerItemId":"29b2ce4f-2f80-45da-b1f5-33194477becb"}],"transactionData":{"data":{"monthlyReports":[{"month":"2025-02-01","transactionsValue":32222,"transactionsCount":3,"refundsValue":0,"refundsNumber":0},{"month":"2025-01-01","transactionsValue":549999,"transactionsCount":1,"refundsValue":549999,"refundsNumber":1},{"month":"2024-12-01","transactionsValue":89999,"transactionsCount":2,"refundsValue":0,"refundsNumber":0},{"month":"2024-11-01","transactionsValue":800000,"transactionsCount":4,"refundsValue":1,"refundsNumber":20000},{"month":"2024-10-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-09-01","transactionsValue":49999,"transactionsCount":3,"refundsValue":49999,"refundsNumber":3},{"month":"2024-08-01","transactionsValue":99989,"transactionsCount":9,"refundsValue":0,"refundsNumber":0},{"month":"2024-07-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-06-01","transactionsValue":1340000,"transactionsCount":1,"refundsValue":0,"refundsNumber":0},{"month":"2024-05-01","transactionsValue":3222299,"transactionsCount":11,"refundsValue":300000,"refundsNumber":1},{"month":"2024-04-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-03-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0}],"firstTransactionDate":"2020-10-10"},"identifier":{"email":"customer@example.com"}},"notificationUrl":"https://example.com/notify","partnerOrderId":"e91f86cea-45ab-42d2-9ae4-ca5501179672","returnUrl":"https://example.com/return","cancelUrl":"https://example.com/cancel","repaymentPeriod":{"type":"DAYS","value":60}}},"partner_with_invoice_list_without_split_payment":{"summary":"Przykład dla Partnerów z listą faktur (bez Split Payment)","value":{"customer":{"email":"customer@example.com","phone":{"number":"1444444444","prefix":"+48"},"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"firstName":"Jan","lastName":"Kowalski"},"items":[{"bankTransferDetails":{"payee":{"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"},"email":"payee@example.com","phone":{"number":"1444444444","prefix":"+48"}},"payeeBankAccount":{"iban":"PL52102023130000380205581980","swift":"BPKOPLPW"},"transferTitle":"Wypłata środków za 2024-03-15"},"invoice":{"merchant":{"registrationNumber":{"country":"PL","registrationNumber":"PL6342427710"},"email":"merchant@example.com","phone":{"number":"9444444444","prefix":"+48"}},"grossValue":{"amount":50000,"currency":"PLN"},"netValue":{"amount":40000,"currency":"PLN"},"dueDate":"2024-03-15","invoiceNumber":"FV05/2024/0001","isSplitPayment":false},"partnerItemId":"29b2ce4f-2f80-45da-b1f5-33194477becb"}],"transactionData":{"data":{"monthlyReports":[{"month":"2025-02-01","transactionsValue":32222,"transactionsCount":3,"refundsValue":0,"refundsNumber":0},{"month":"2025-01-01","transactionsValue":549999,"transactionsCount":1,"refundsValue":549999,"refundsNumber":1},{"month":"2024-12-01","transactionsValue":89999,"transactionsCount":2,"refundsValue":0,"refundsNumber":0},{"month":"2024-11-01","transactionsValue":800000,"transactionsCount":4,"refundsValue":1,"refundsNumber":20000},{"month":"2024-10-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-09-01","transactionsValue":49999,"transactionsCount":3,"refundsValue":49999,"refundsNumber":3},{"month":"2024-08-01","transactionsValue":99989,"transactionsCount":9,"refundsValue":0,"refundsNumber":0},{"month":"2024-07-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-06-01","transactionsValue":1340000,"transactionsCount":1,"refundsValue":0,"refundsNumber":0},{"month":"2024-05-01","transactionsValue":3222299,"transactionsCount":11,"refundsValue":300000,"refundsNumber":1},{"month":"2024-04-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-03-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0}],"firstTransactionDate":"2020-10-10"},"identifier":{"email":"customer@example.com"}},"notificationUrl":"https://example.com/notify","partnerOrderId":"e5d95044-fe0a-48cd-8fed-e602a511f824","returnUrl":"https://example.com/return","cancelUrl":"https://example.com/cancel","repaymentPeriod":{"type":"DAYS","value":60}}},"stores_and_sales_platforms":{"summary":"Przykład dla sklepów i platform sprzedażowych","value":{"customer":{"email":"customer@example.com","phone":{"number":"1444444444","prefix":"+48"},"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"}},"items":[{"bankTransferDetails":{"payee":{"registrationNumber":{"country":"PL","registrationNumber":"PL9452188308"}},"payeeBankAccount":{"iban":"PL52102023130000380205581980"}},"value":{"amount":50000,"currency":"PLN"},"merchant":{"registrationNumber":{"country":"PL","registrationNumber":"PL6342427710"}}}],"transactionData":{"data":{"monthlyReports":[{"month":"2025-02-01","transactionsValue":32222,"transactionsCount":3,"refundsValue":0,"refundsNumber":0},{"month":"2025-01-01","transactionsValue":549999,"transactionsCount":1,"refundsValue":549999,"refundsNumber":1},{"month":"2024-12-01","transactionsValue":89999,"transactionsCount":2,"refundsValue":0,"refundsNumber":0},{"month":"2024-11-01","transactionsValue":800000,"transactionsCount":4,"refundsValue":1,"refundsNumber":20000},{"month":"2024-10-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-09-01","transactionsValue":49999,"transactionsCount":3,"refundsValue":49999,"refundsNumber":3},{"month":"2024-08-01","transactionsValue":99989,"transactionsCount":9,"refundsValue":0,"refundsNumber":0},{"month":"2024-07-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-06-01","transactionsValue":1340000,"transactionsCount":1,"refundsValue":0,"refundsNumber":0},{"month":"2024-05-01","transactionsValue":3222299,"transactionsCount":11,"refundsValue":300000,"refundsNumber":1},{"month":"2024-04-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0},{"month":"2024-03-01","transactionsValue":0,"transactionsCount":0,"refundsValue":0,"refundsNumber":0}]}},"notificationUrl":"https://example.com/notify","partnerOrderId":"cc523436-bfb5-4640-b674-c0b97429d63e","returnUrl":"https://example.com/return"}}},"securitySchemes":{"Bearer":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"support@pragmago.tech","name":"API Support"},"title":"PragmaPay","version":"1.0.0"},"openapi":"3.0.0","paths":{"/api/partner/authorize":{"post":{"operationId":"post_app_security_authentication_authorizepartner","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/authorize_partner_request"}}},"description":"Dane logowania Partnera","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/authorize_partner_response"}}},"description":"Zwraca token i refresh token"},"401":{"description":"Nieautoryzowany dostęp"},"403":{"description":"Zabroniony"}},"tags":["Metoda płatności PragmaPay"]}},"/api/partner/authorize/refresh":{"post":{"operationId":"post_app_security_authentication_authorizerefresh","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/refresh_token_request"}}},"description":"Refresh token"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/authorize_partner_response"}}},"description":"Zwraca token i refresh token"},"401":{"description":"Nieautoryzowany dostęp"},"403":{"description":"Zabroniony"}},"tags":["Metoda płatności PragmaPay"]}},"/api/v2/partner/payment":{"post":{"operationId":"post_create_payment_action","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loan_create_payment_request"},"examples":{"payment_gateway":{"$ref":"#/components/examples/payment_gateway"},"marketplace":{"$ref":"#/components/examples/marketplace"},"partner_with_invoice_list_and_split_payment":{"$ref":"#/components/examples/partner_with_invoice_list_and_split_payment"},"partner_with_invoice_list_without_split_payment":{"$ref":"#/components/examples/partner_with_invoice_list_without_split_payment"},"stores_and_sales_platforms":{"$ref":"#/components/examples/stores_and_sales_platforms"}}}},"description":"Dane do płatności"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loan_create_payment_response"}}},"description":"Grupa o podanym ID istnieje już w systemie"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loan_create_payment_response"}}},"description":"Poprawne złożenie grupy wniosków"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/validation_errors"}}},"description":"Błąd walidacji żądania"},"403":{"description":"Zabroniony"},"404":{"description":"Nie znaleziono płatności"}},"security":[{"Bearer":[]}],"tags":["Metoda płatności PragmaPay"]}},"/api/v2/partner/payment/{paymentId}/update":{"patch":{"operationId":"patch_update_payment_action","parameters":[{"description":"ID otrzymane wraz z kodem 2XX po wyzwoleniu akcji z wyborem metody płatności PragmaPay","in":"path","name":"paymentId","required":true,"schema":{"format":"uuid","type":"string","example":"012ef0b7-a54e-44ed-be2f-1444f5c57045"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loan_update_payment_request"}}},"description":"Dane do aktualizacji płatności"},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loan_update_payment_response"}}},"description":"Przyjęto żądanie utworzenia zwrotu"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/validation_errors"}}},"description":"Błąd walidacji"},"403":{"description":"Zabroniony"},"404":{"description":"Nie znaleziono płatności"}},"security":[{"Bearer":[]}],"tags":["Metoda płatności PragmaPay"]}},"/api/v2/partner/payment/{paymentId}/confirm":{"patch":{"operationId":"patch_confirm_payment_action","parameters":[{"description":"ID otrzymane wraz z kodem 2XX po wyzwoleniu akcji z wyborem metody płatności PragmaPay","in":"path","name":"paymentId","required":true,"schema":{"format":"uuid","type":"string","example":"012ef0b7-a54e-44ed-be2f-1444f5c57045"}}],"responses":{"202":{"description":"Przyjęto żądanie zmiany statusu"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/validation_errors"}}},"description":"Błędny parametr żądania"},"403":{"description":"Zabroniony"},"404":{"description":"Nie znaleziono płatności"}},"security":[{"Bearer":[]}],"tags":["Metoda płatności PragmaPay"]}},"/api/v2/partner/payment/{paymentId}/cancel":{"patch":{"operationId":"patch_cancel_payment_action","parameters":[{"description":"ID otrzymane wraz z kodem 2XX po wyzwoleniu akcji z wyborem metody płatności PragmaPay","in":"path","name":"paymentId","required":true,"schema":{"format":"uuid","type":"string","example":"012ef0b7-a54e-44ed-be2f-1444f5c57045"}}],"responses":{"202":{"description":"Przyjęto żądanie zmiany statusu"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/validation_errors"}}},"description":"Błąd walidacji"},"403":{"description":"Zabroniony"},"404":{"description":"Nie znaleziono płatności"}},"security":[{"Bearer":[]}],"tags":["Metoda płatności PragmaPay"]}},"/api/v2/partner/payment/{paymentId}":{"get":{"operationId":"get_check_payment_action","parameters":[{"description":"ID otrzymane wraz z kodem 2XX po wyzwoleniu akcji z wyborem metody płatności PragmaPay","in":"path","name":"paymentId","required":true,"schema":{"format":"uuid","type":"string","example":"012ef0b7-a54e-44ed-be2f-1444f5c57045"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loan_get_payment_response"}}},"description":"Ok. Pobranie szczegółów pożyczki"},"403":{"description":"Zabroniony"},"404":{"description":"Nie znaleziono płatności"}},"security":[{"Bearer":[]}],"tags":["Metoda płatności PragmaPay"]}},"/api/partner/payment/calculator":{"get":{"operationId":"get_app_partner_loan_calculateaction__invoke","parameters":[{"description":"Wartość zamówienia (Brutto)","in":"query","name":"value[amount]","required":true,"schema":{"example":91458,"type":"number"}},{"description":"Waluta zamówienia","in":"query","name":"value[currency]","required":true,"schema":{"example":"PLN","type":"string"}},{"description":"Tryb okresu spłat, możliwe opcje to odroczenie płatności i rozłożenie na raty","in":"query","name":"repaymentPeriod[type]","required":true,"schema":{"enum":["installments","days"],"example":"days","type":"string"}},{"description":"Wartość liczbowa korespondująca z typem (liczba dni lub rat). Wartości indywidualnie ustalane z partnerem. Domyślnie: \nINSTALLMENTS: 3, 6, 9 i 12 \nDAYS: 14,30,60","example":30,"in":"query","name":"repaymentPeriod[value]","required":true,"schema":{"type":"number"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/loan_calculate_response"}}},"description":"OK"},"400":{"description":"Błędny parametr żądania"},"403":{"description":"Zabroniony"}},"security":[{"Bearer":[]}],"tags":["Metoda płatności PragmaPay"]}},"/api/test/{hash}/payment/{paymentId}/current_token":{"get":{"operationId":"get_app_test_payment_gettokens","parameters":[{"description":"Parametr hash dla środowiska testowego otrzymany od PragmaGO w procesie integracji","in":"path","name":"hash","required":true,"schema":{"type":"string","example":"502520e8-c6f9-4a69-bf0c-24fcac759861"}},{"description":"ID otrzymane wraz z kodem 2XX po wyzwoleniu akcji z wyborem metody płatności PragmaPay","in":"path","name":"paymentId","required":true,"schema":{"format":"uuid","type":"string","example":"012ef0b7-a54e-44ed-be2f-1444f5c57045"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/test_get_sms_token_response"}}},"description":"Ok. Pobranie tokenu SMS"},"403":{"description":"Zabroniony"},"404":{"description":"Nie znaleziono tokenu"}},"tags":["Metoda płatności PragmaPay"]}}},"servers":[{"url":"https://api-partner.box.pragmago.tech"}],"x-readme":{"explorer-enabled":true,"proxy-enabled":true,"samples-enabled":true}}