Skip to main content

Pay-by-link (Slovakia)

tip

Accepting this payment channel requires an additional agreement with the acquiring agent designated by dpay.pl. Contact your dpay.pl account manager to activate Slovak banks for your service.

dpay.pl enables direct integration with banks in Slovakia using the white-label method (Pay-by-Link). The customer is redirected directly to the selected bank, without an intermediary gateway page.

POST/api/v1_0/payments/registerFull payment registration contract: parameters, checksum, and error codes.Full contract in the API Reference

Supported banks​

BankChannel IDCurrency
Viamo363EUR
Postova banka354EUR
Slovenska sporitelna357EUR
Tatra banka360EUR
ePlatby VUB366EUR

Transaction registration​

Use the standard payment registration endpoint with the transfers transaction type, the EUR currency, and the channel field identifying the selected bank:

POST https://api-payments.dpay.pl/api/v1_0/payments/register
Content-Type: application/json
The channel field and its dependent fields

For a white-label integration, the channel field is mandatory. Without it, the system will not know which bank to redirect the customer to. Providing channel also requires the email, client_name, client_surname, and accept_tos fields (confirmation that the customer has accepted the terms and conditions). Omitting any of them results in a validation error (HTTP 422).

Request example​

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": "customer@example.com",
    "client_name": "Jan",
    "client_surname": "Kovac",
    "accept_tos": true,
    "url_success": "https://myshop.example/success",
    "url_fail": "https://myshop.example/failure",
    "url_ipn": "https://myshop.example/api/ipn",
    "checksum": "e3b0c44298fc1c149afb..."
  }'

The checksum is generated in the same way as for a standard payment (with the amount formatted to two decimal places):

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

Response​

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

Redirect the customer to the address in the msg field. For a complete description of the request and response formats and error handling, see Pay-by-link (Czech Republic). The integrations differ only in their currency (EUR) and channel IDs.

IPN handling​

IPN notifications work in the same way as for standard payments. See IPN handling for details.

Last updated on