Przejdź do głównej zawartości

Pay-by-link (Słowacja)

wskazówka

Akceptacja tego kanału płatności wymaga dodatkowej umowy z agentem rozliczeniowym wskazanym przez dpay.pl. Skontaktuj się z opiekunem handlowym dpay.pl, aby aktywować banki słowackie dla Twojego serwisu.

dpay.pl umożliwia bezpośrednią integrację z bankami na Słowacji za pomocą metody white-label (Pay-by-Link). Klient jest przekierowywany bezpośrednio do wybranego banku, bez pośredniej strony bramki.

POST/api/v1_0/payments/registerPełny kontrakt rejestracji płatności: parametry, checksum i kody błędów.Pełny kontrakt w API Reference

Obsługiwane banki​

BankChannel IDWaluta
Viamo363EUR
Postova banka354EUR
Slovenska sporitelna357EUR
Tatra banka360EUR
ePlatby VUB366EUR

Rejestracja transakcji​

Użyj standardowego endpointu rejestracji płatności z typem transakcji transfers, walutą EUR oraz polem channel wskazującym wybrany bank:

POST https://api-payments.dpay.pl/api/v1_0/payments/register
Content-Type: application/json
Pole channel i pola towarzyszące

W przypadku integracji white-label pole channel jest obowiązkowe - bez niego system nie będzie wiedzieć, do którego banku przekierować klienta. Podanie channel wymaga jednocześnie przekazania pól email, client_name, client_surname oraz accept_tos (potwierdzenie akceptacji regulaminu przez klienta). Ich brak spowoduje błąd walidacji (HTTP 422).

Przykład zapytania​

curl -X POST https://api-payments.dpay.pl/api/v1_0/payments/register \
  -H "Content-Type: application/json" \
  -d '{
    "transactionType": "transfers",
    "service": "abc123",
    "value": "49.00",
    "currency_code": "EUR",
    "channel": "360",
    "email": "klient@example.com",
    "client_name": "Jan",
    "client_surname": "Kovac",
    "accept_tos": true,
    "url_success": "https://mojsklep.sk/sukces",
    "url_fail": "https://mojsklep.sk/blad",
    "url_ipn": "https://mojsklep.sk/api/ipn",
    "checksum": "e3b0c44298fc1c149afb..."
  }'

Checksum generowany jest identycznie jak dla standardowej płatności (kwota w formacie dwóch miejsc po przecinku):

sha256({service}|{SecretHash}|{value}|{url_success}|{url_fail}|{url_ipn})

Odpowiedź​

{
  "error": false,
  "msg": "https://secure.dpay.pl/transfer@pay@abc123def456",
  "status": true,
  "transactionId": "42191111-A7AE-392E-8C09-7965C1DC6B0B"
}

Przekieruj klienta na adres z pola msg. Pełny opis formatu zapytania, odpowiedzi i obsługi błędów znajdziesz w Pay-by-link (Czechy) - integracje różnią się jedynie walutą (EUR) i identyfikatorami kanałów.

Obsługa IPN​

Powiadomienia IPN działają identycznie jak dla standardowych płatności. Szczegóły znajdziesz w Obsługa IPN.

Ostatnia aktualizacja dnia