API Reference

O usłudze PragmaPay

Poniżej znajdziesz niezbędne informacje na temat integracji metody płatności PragmaPay.

📘

Najważniejsze pojęcia wykorzystywane w dokumentacji

  • PragmaGO - potocznie Pragma, to ogólna nazwa dla dowolnego z aktorów po stronie PragmaGO. Może być nim system lub użytkownik/grupa. Uogólnienie zostało wprowadzone ze względu na to, że nie jest to istotne dla odbiorców dokumentacji w tym projekcie.
  • PragmaPay - to metoda płatności, w której klient kupuje produkt lub usługę, ale nie dokonuje natychmiastowej płatności lub odracza płatność za fakturę. W przeciwieństwie do tradycyjnego zakupu, w przypadku płatności metodą PragmaPay, klient otrzymuje produkt, korzysta z usługi lub opłaca fakturę Sprzedawcy, a płatność za towar, usługę lub fakturę zostaje przesunięta w czasie.
    PragmaPay może przybierać różne formy. Domyślnie umożliwiamy Klientom 2 warianty:
    • Odroczenie płatności: Klient spłaca całość zobowiązania jednorazowo w określonym terminie.
    • Płatność ratalna: Klient dzieli całkowitą kwotę na raty (wybraną liczbę miesięcy)
  • Partner - podmiot biznesowy, który nawiązuje strategiczną relację z PragmaGO. Wdraża u siebie jeden z produktów PragmaGO, w tym przypadku metodę płatności PragmaPay.

📖 Informacje ogólne

  1. Dokumentacja jest pisana przez IT dla IT, dla programistów, analityków, testerów, PM, PO etc. Proponujemy zatem przejść na “Ty” - od tego miejsca w takiej formie będzie pisana dokumentacja.
  2. Za cały proces integracji, ustalenia biznesowe, wsparcie i rekomendowanie rozwiązań po stronie PragmaGO jest odpowiedzialny Opiekun Biznesowy. Jeśli nie został on wskazany czy przydzielony firmie, w której pracujesz, napisz na adres: [email protected].
  3. Dostęp do środowiska produkcyjnego, konfigurację metody płatności PragmaPay, informacje o wszystkich płatnościach i wiele innych znajdziesz w Strefie Partnera. Dzięki niej sami zarządzacie integracją.

    i) Jeśli nie otrzymałeś jeszcze dostępów do Strefy Partnera, skontaktuj się ze swoim Opiekunem Biznesowym.

    ii) Jeśli nie został jeszcze przydzielony, to patrz punkt wyżej :)

📄 Diagramy

Proces po wybraniu metody płatności PragmaPay przy wyborze wariantu Pop-up

Proces po wybraniu metody płatności PragmaPay przy wyborze wariantu z przekierowaniem na formularz PragmaPay

💻 Export API

Jeśli chcesz testować API z użyciem własnego narzędzia, możesz pobrać specyfikację:

📋 Spis treści API

Sugerujemy przejcie integracji zgodnie z listą Integracja krok po kroku. Informacje o akcjach i powiadomieniach znajdziesz również w spisie treści poniżej:

  1. Autoryzacja
  2. Wybranie metody płatności PragmaPay
  3. Zmiana statusu płatności - notyfikacja
  4. Pobranie wartości limitu
  5. Zwroty zamówień
  6. Potwierdzenie zamówienia przed finansowaniem
  7. Anulowanie płatności
  8. Sprawdzenie statusu płatności PragmaPay
  9. Kalkulator spłaty w PragmaPay
  10. Słownik statusów płatności PragmaPay