API Reference

Wybranie metody płatności PragmaPay

post
https://api-partner.box.pragmago.tech/api/v2/partner/payment

Akcja, którą należy wyzwolić po wyborze przez Klienta metody płatności PragmaPay.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Przesłanie jak największej ilości danych w tej akcji skutkuje prostszym procesem dla Klienta, a co za tym idzie istotnie wyższą konwersją.

📘

Informacje dodatkowe

  • Przesyłając w poniższej akcji więcej niż jeden obiekt item, należy uwzględnić, że domyślnie PragmaGO umożliwi finansowanie wszystkich przesłanych itemów lub żadnego.
  • W przypadku, gdyby Klient otrzymał limit wystarczający na sfinansowanie tylko części z nich, ale nie wszystkich, całe zamówienie Klienta nie zostanie opłacone.
  • Aby omówić potencjalną zmianę domyślnego działania, należy skontaktować się z Opiekunem Biznesowym po stronie PragmaGO.

📘

Przykłady zapytań

Przykładowy request możesz wygenerować używając kreatora poniżej lub skorzystać z gotowych przykładów.

Body Params

Dane do płatności

string

Adres powrotu przy ścieżkach negatywnych.

Na 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.

W przypadku braku przesłania, Klient zostanie przekierowany na returnUrl.

customer
object
required

Dane Klienta, który wybrał metodę płatności PragmaPay.
Czym więcej danych zostanie przesłanych tym proces dla Klienta jest krótszy i tym wyższa jest konwersja.

items
array of objects
required

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 jednego 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 nie odpowiadają pojedynczym produktom z koszyka Klienta.

items*
transactionData
object
required

Dane transakcyjne danego Klienta. Mają na celu zwiększyć dopasowanie limitu finansowania.

string
required

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.

uuid
required

Unikalne ID zamówienia po stronie Partnera. Nie może być dwóch zamówień po stronie Partnera z tym samym ID.
W 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).

repaymentPeriod
object

Taki okres spłaty ustawi się Klientowi domyślnie.
Klient ma możliwość zmiany okresu spłaty po przejściu na proces po stronie PragmaGO.

availableRepaymentPeriods
array of objects

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.
Przykład:
Partner 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.

availableRepaymentPeriods
string
required

Domyślny adres powrotu (do Partnera/Sklepu etc).

Na ten adres zostanie przekierowany Klient po opłaceniu zamówienia metodą PragmaPay.

integer

Czas, po którym płatność zostanie automatycznie odrzucona. Domyślna wartość to 24h.

Minimalny czas ważności formularza to 1h, maksymalny to 168h.

string

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ę.

Responses

403

Zabroniony

404

Nie znaleziono płatności

Updated 6 months ago

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago