Tpay
API

Raty

Płatności ratalne to metoda finansowania, która pozwala konsumentom rozłożyć koszt zakupu na kilka mniejszych, regularnych płatności, zamiast zapłacić całą kwotę z góry.

Jak działa system płatności ratalnych?

Proces zakupu na raty zazwyczaj obejmuje następujące kroki:

  1. Wybór produktu lub usługi: Klient wybiera produkt lub usługę, którą chce zakupić i dodaje ją do koszyka zakupowego.
  2. Wybór metody płatności: Spośród dostępnych metod płatności, klient wybiera opcję Płatność na raty lub Raty i wybiera odpowiadający mu plan ratalny.
  3. Weryfikacja kredytowa: Dostawca usługi ratalnej przeprowadza weryfikację zdolności kredytowej klienta, aby ocenić jego zdolność do spłaty rat.
  4. Ustalenie warunków finansowania: Klient akceptuje zaproponowany mu plan ratalny, uwzględniający liczbę rat i wysokość miesięcznych płatności. Warunki te mogą obejmować także ewentualne oprocentowanie i dodatkowe opłaty.
  5. Podpisanie umowy: Klient ostatecznie akceptuje warunki płatności ratalnych podpisując umowę finansową. W przypadku zakupów online akceptacja jest zazwyczaj cyfrowa.
  6. Otrzymanie produktu lub usługi: Po zatwierdzeniu płatności ratalnej, klient otrzymuje produkt lub usługę zgodnie z polityką dostawy sprzedawcy.
  7. Regularne płatności: Klient dokonuje regularnych płatności ratalnych zgodnie z ustalonym harmonogramem, aż do spłaty pełnej kwoty zakupu.

Dostępni dostawcy ratalni

Udostępniamy trzech dostawców płatności ratalnych: Raty Pekao, Alior Raty i PragmaPay.

PragmaPay Płatności ratalne dla biznesu

Warunki korzystania z usługi

  • Minimalna kwota to 100 PLN, maksymalna 50 000 PLN .
  • Czas na spłatę to 3, 6, 9 lub 12 miesięcy.
  • Kod MCC spoza tabeli poniej
Kod MCCNazwa kodu
1041Produkcja olejów i pozostałych tłuszczów płynnych
1101Destylowanie, rektyfikowanie i mieszanie alkoholi
2446Wytwarzanie paliw jądrowych
2540Produkcja broni i amunicji
4612Działalność agentów zajmujących się sprzedażą paliw, rud, metali i chemikaliów przemysłowych
4671Sprzedaż hurtowa paliw i produktów pochodnych
4672Sprzedaż hurtowa metali i rud metali
4677Sprzedaż hurtowa odpadów i złomu
9200Działalność związana z grami losowymi i zakładami wzajemnymi
9491Działalność organizacji religijnych
9492Działalność organizacji politycznych
9405Organizacje i stowarszyszenia

Transakcja ratalna

Realizuj płatności ratalne wykorzystując endpoint zakładania transakcji, podając odpowiedni identyfikator kanału płatniczego.

Nazwa kanału płatniczegoChannelId - identyfikator
Raty Pekao 1%77
Raty Pekao 3 x 0%78
Raty Pekao do 10 x 080
Raty Pekao 0,7%81
Alior Raty49
PragmaPay płatności ratalne dla biznesu86

Wyślij zapytanie o utworzenie transakcji ratalnej

Aby utworzyć transakcję ratalną, wyślij żądanie POST na endpoint:

https://api.tpay.com/transactions

Sprawdź szczegóły w dokumentacji API Reference: POST /transactions

W zapytaniu określ następujące parametry:

amount
Kwota transakcji (w złotówkach).
description
Opis transakcji widoczny dla płatnika.
payer.email
Adres e-mail płatnika.
payer.name
Imię i nazwisko płatnika.
pay.channelId
Identyfikator kanału płatności ratalnej.

Podstawowe body żądania powinno wyglądać następująco:

{
  "amount": 0.1,
  "description": "Testowa transakcja ratalna",
  "payer": {
    "email": "[email protected]",
    "name": "Jan Nowak"
  },
  "pay": {
    "channelId": 77
  }
}

Przykład:

curl --location 'https://api.tpay.com/transactions' \
--header 'Authorization: Bearer <access_token>' \
--header 'Content-Type: application/json' \
--data-raw '{
   "amount": 0.1,
   "description": "Testowa transakcja ratalna",
   "payer": {
      "email": "[email protected]",
      "name": "Jan Nowak"
   },
   "pay": {
      "channelId": 77
   }
}'

Po wysłaniu żądania otrzymasz w odpowiedzi schemat TransactionCreated.

Najważniejsze parametry odpowiedzi:

result
success - Transakcja została utworzona pomyślnie.
status
pending - Transakcja oczekuje opłacenia.
transactionPaymentUrl
Adres URL, na który należy przekierować płatnika.

Przykład odpowiedzi:

{
  "result": "success",
  "requestId": "786dee7ec39502226238",
  "transactionId": "ta_73qDVKjNvNQ5GbLn",
  "title": "TR-CWM-D14339X",
  "posId": "ps_e4dkPVDEm4Jg726q",
  "status": "pending",
  "date": {
    "creation": "2024-07-04 21:15:23",
    "realization": null
  },
  "amount": 0.1,
  "currency": "PLN",
  "description": "Testowa transakcja ratalna",
  "hiddenDescription": "",
  "payer": {
    "payerId": "py_a9rjlZWxRLdG1bqY",
    "email": "[email protected]",
    "name": "Jan Nowak",
    "phone": "",
    "address": "",
    "city": "",
    "country": "PL",
    "postalCode": ""
  },
  "payments": {
    "status": "pending",
    "method": "pay_by_link",
    "amountPaid": 0,
    "date": {
      "realization": null
    }
  },
  "transactionPaymentUrl": "https://secure.tpay.com/?title=TR-CWM-D14339X&uid=01J1ZJREPKDXXJ5E4JRWYVXMN2"
}

Przekieruj płatnika do wniosku ratalnego

Przekieruj płatnika na URL zawarty w odpowiedzi w polu transactionPaymentUrl.

Pod wskazanym URL płatnik zostanie przekierowany do wniosku ratalnego, gdzie uzupełnia dane i zatwierdza wniosek.

Obsłuż powiadomienie

Poinformujemy Ciebie o statusie transakcji za pośrednictwem notyfikacji po zaksięgowaniu transakcji.

Kalkulator Rat Pekao

Kalkulator Rat z Bankiem Pekao możesz umieścić na swojej stronie w dowolnym miejscu (np. na karcie produktowej).

Dzięki temu klienci będą samodzielne obliczać liczbę lub wysokość rat.

Skopiuj kod

W celu wyświetlenie kalkulatora rat skopiuj w tym poniższy kod źródłowy i umieść go w wybranym miejscu.

Kalkulator rat Pekao 1%:

<iframe src="https://secure.tpay.com/installments/calculator?channelId=77" mce_src="https://secure.tpay.com/installments/calculator?channelId=77" width="680" height="680" frameborder="0"> </iframe>

Kalkulator rat Pekao 3 x 0%:

<iframe src="https://secure.tpay.com/installments/calculator?channelId=78" mce_src="https://secure.tpay.com/installments/calculator?channelId=78" width="680" height="680" frameborder="0"> </iframe>

Kalkulator rat Pekao 0,7%:

<iframe src="https://secure.tpay.com/installments/calculator?channelId=81" mce_src="https://secure.tpay.com/installments/calculator?channelId=81" width="680" height="680" frameborder="0"> </iframe>

Kalkulator rat Pekao 10 x 0%:

<iframe src="https://secure.tpay.com/installments/calculator?channelId=80" mce_src="https://secure.tpay.com/installments/calculator?channelId=80" width="680" height="680" frameborder="0"> </iframe>
Uwaga

Kalkulator rat Pekao można tak ustawić, by na kartach produktów była widoczna proponowana cena w podziale na raty - dowiedz się, jak to zrobić.

Promowanie

Możesz również skorzystać z banerów z napisem Sprawdź ratę lub Oblicz ratę - osadź je na stronie w taki sposób, by po kliknięciu wyświetlił się kalkulator. Banery do pobrania.

Dowiedz się więcej na temat promowania rat Pekao.

Kalkulator Alior Raty

Kalkulator Alior Raty możesz umieścić na swojej stronie w dowolnym miejscu (np. na karcie produktowej).

Dzięki temu klienci będą samodzielne obliczać liczbę lub wysokość rat.

Skopiuj kod

W celu wyświetlenie kalkulatora rat skopiuj w tym poniższy kod źródłowy i umieść go w wybranym miejscu.

<iframe src="https://secure.tpay.com/alior-raty/?range&logo" mce_src="https://secure.tpay.com/alior-raty/?range&logo" width="680" height="600" frameborder="0"> </iframe>