Przelew Online - Pay-By-Link

Przelew online inaczej Pay-By-Link to metoda płatności, w której płatnik wybiera bank, w którym posiada konto internetowe i z którego chce opłacić transakcję. Następnie zostaje przekierowany stronę logowania do bankowości elektronicznej. Po zalogowaniu się w systemie bankowym płatnikowi pojawia się automatycznie wypełniony formularz płatności, który musi zatwierdzić. Płatnik nie ma możliwości edycji tych danych, jedynie może potwierdzić transakcję. Po udanej autoryzacji transakcji płatnik jest ponownie przekierowany na Panel Transakcyjny, a jego konto zostaje obciążone wartością transakcji.

Sprawdź więcej.

Zanim zaczniesz

Upewnij się, że:

Lista dostępnych banków wraz z identyfikatorem `channelId`

ChannelId - identyfikator	Nazwa banku
1	BNP Paribas Bank Polska S.A.
2	Bank Millennium S.A.
4	Bank Pekao S.A.
5	Bank Pocztowy S.A.
6	Santander Bank Polska S.A.
7	Citibank Handlowy S.A.
9	Alior Bank S.A.
12	VeloBank S.A.
13	ING Bank Śląski S.A.
14	Inteligo
15	Plus Bank S.A.
17	Credit Agricole Polska S.A.
18	mBank
21	PKO Bank Polski (iPKO)
63	Banki Spółdzielcze

Transakcja Pay-By-Link

Realizuj płatności Pay-By-Link, wykorzystując endpoint zakładania transakcji.

Wyślij zapytanie o utworzenie transakcji Pay-By-Link

Aby utworzyć transakcję Pay-By-Link, wyślij żądanie POST na endpoint podając odpowiedni parametr channelId przypisany dla danego banku:

https://api.tpay.com/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 dla wybranego banku.

Uwaga

Kanały płatnicze, które obsługują Pay-By-Link, mają atrybuty:

onlinePayment	true
instantRedirection	true

Sprawdź więcej informacji o kanałach płatności.

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

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

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 PBL",
   "payer": {
      "email": "[email protected]",
      "name": "Jan Nowak"
   },
  "pay" : {
    "channelId": 1
  }
}'

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 na opłacenie.
transactionId	Unikalny identyfikator transakcji.
transactionPaymentUrl	Adres URL, na który należy przekierować płatnika.

Przykład:

{
  "result": "success",
  "requestId": "cf47fa58ad6679fb6a86",
  "transactionId": "ta_jrkNGj5xnppBlbqw",
  "title": "TR-CWM-D02D7HX",
  "posId": "ps_e4dkPVDEm4Jg726q",
  "status": "pending",
  "date": {
    "creation": "2024-07-01 21:38:13",
    "realization": null
  },
  "amount": 0.1,
  "currency": "PLN",
  "description": "Testowa transakcja",
  "hiddenDescription": "",
  "payer": {
    "payerId": "py_a9rjlZWxRLdG1bqY",
    "email": "[email protected]",
    "name": "Jan Nowak",
    "phone": "",
    "address": "",
    "city": "",
    "country": "PL",
    "postalCode": ""
  },
  "payments": {
    "status": "pending",
    "method": null,
    "amountPaid": 0,
    "date": {
      "realization": null
    }
  },
  "transactionPaymentUrl": "https://secure.tpay.com/?gtitle=TR-CWM-D02D7HX&uid=01J1QWW3AN9RYYSA978ECND8Z3"
}

Uwaga

Parametr transactionId przechowaj w swoim systemie. Więcej o transactionId.

Przekieruj płatnika do systemu bankowego

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

Gdy płatnik zostanie przekierowany do systemu bankowego, loguje się swoimi danymi dostępowymi.

Zostanie mu wyświetlony formularz opłacenia transakcji, który musi zaakceptować, aby sfinalizować płatność.

Płatnik zostanie przekierowany na stronę sukcesu lub porażki

Gdy płatność zostanie zakończona, płatnik zostanie przekierowany na stronę sukcesu (success page) lub stronę porażki (error page) w zależności od tego, czy transakcja się udała.

Obsłuż powiadomienie

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