Płatności w walutach

Tpay umożliwia prezentowanie i rozliczanie płatności w walutach innych niż PLN. Obecnie taka możliwość dotyczy wyłącznie płatności kartą – inne metody płatności nie wspierają jeszcze walut.

Uwaga

Poniższe rozwiązania dotyczą płatności kartą. Kolejne metody płatności będą dodawane do tej strony w miarę ich udostępniania.

Zanim zaczniesz

Upewnij się, że:

Karty – płatności z rozliczeniem w walucie lokalnej

Na potrzeby płatności kartą rozróżniamy kilka rozwiązań związanych z walutami. Różnią się tym, kto decyduje o walucie obciążenia karty oraz w jakiej walucie akceptant otrzymuje środki.

Płatność każdą kartą w dowolnej walucie (konwersja u wydawcy)

Płatnik może zapłacić kartą w dowolnej walucie niezależnie od waluty, w jakiej została zaprezentowana płatność. Jest to standardowy mechanizm płatności kartowych, niezależny od Tpay i od acquirera – dotyczy każdej karty i każdego acquirera.

Konwersji dokonuje wydawca karty (bank płatnika), a z karty płatnika pobierana jest kwota przeliczona na walutę tej karty. Akceptant zawsze otrzymuje płatność w walucie, w jakiej założył transakcję.

W tym rozwiązaniu płatnik nie ma pewności co do dokładnej kwoty obciążenia karty – kurs przeliczenia ustala wydawca karty. Przybliżona kwota jest jednak łatwa do ustalenia dla płatnika, na bazie aktualnych kursów walut.

Przykład

Płatność została zaprezentowana w wysokości 100 PLN, a płatnik płaci kartą wydaną w EUR:

płatnik widzi w bramce kwotę do zapłaty: 100 PLN,
realizuje płatność na 100 PLN,
w historii karty widzi płatność na 100 PLN oraz kwotę faktycznie pobraną z karty w EUR (np. 25 EUR),
akceptant otrzymuje płatność w PLN.

DCC (Dynamic Currency Conversion)

DCC to usługa przeliczenia kwoty transakcji „w locie” na walutę karty płatnika, gdy waluta płatności różni się od waluty karty. W odróżnieniu od konwersji u wydawcy, przeliczenie następuje już na etapie płatności, a płatnik może wybrać walutę obciążenia. W tym rozwiązaniu płatnik widzi dokładną kwotę płatności w swojej walucie, zanim podejmie decyzję o zapłaceniu.

Uwaga

DCC jest obecnie dostępne wyłącznie z acquirerem Elavon. Aby aktywować to rozwiązanie lub sprawdzić, czy jest już włączone na Twoim koncie, skontaktuj się z działem wsparcia Tpay.

Korzystanie z DCC nie różni się dla integrującego od standardowej płatności kartowej – nie musisz nic zmieniać ani dodawać w swojej integracji. Różnicę zobaczy jedynie płatnik: pomiędzy wypełnieniem formularza kartowego a rozpoczęciem procesowania płatności (uwierzytelnieniem 3DS) zostaną mu zaprezentowane dodatkowe ekrany, na których wybiera walutę obciążenia.

Przykład

Płatność została zaprezentowana w wysokości 100 PLN, a płatnik płaci kartą wydaną w EUR:

płatnik widzi w bramce kwotę do zapłaty: 100 PLN,
po podaniu danych karty system sprawdza, czy DCC jest możliwe – jeśli tak, płatnikowi zostaje przedstawiony wybór waluty obciążenia: 100 PLN albo np. 25 EUR,
płatnik realizuje płatność w wybranej walucie,
jeśli wybrał 100 PLN – w historii karty zobaczy płatność na 100 PLN oraz kwotę pobraną z karty w EUR (np. 25 EUR),
jeśli wybrał 25 EUR – w historii karty zobaczy płatność na 25 EUR,
akceptant zawsze otrzymuje płatność w walucie, w jakiej założył transakcję (w tym przykładzie w PLN).

Ograniczenia

DCC zadziała wyłącznie podczas płatności numerem karty – w praktyce nie zadziała więc dla większości płatności Apple Pay, Google Pay i Click to Pay, które odbywają się tokenem portfela.
DCC nie jest dostępne dla płatności cyklicznych (rekurencyjnych).

Uwaga

Zwroty w DCC są realizowane po kursie wymiany obowiązującym w dniu zwrotu, a nie w dniu sprzedaży – warto mieć na uwadze możliwe różnice kursowe pomiędzy dniem sprzedaży i dniem zwrotu.

Karty - płatność z rozliczeniem w dowolnej walucie (multi-currency)

Multi-currency to możliwość zaprezentowania i rozliczenia transakcji kartowej w walucie innej niż PLN – bez potrzeby korzystania z konwersji u wydawcy karty czy z DCC. Akceptant otrzymuje środki bezpośrednio w walucie, w jakiej założył transakcję lub innej ustalonej z acquirerem.

Uwaga

Rozwiązanie jest dostępne obecnie wyłącznie z acquirerem Worldline. Obsługa multi-currency dla innych acquirerów jest w przygotowaniu.

Przykłady

Płatność została zaprezentowana w wysokości 100 EUR, a płatnik płaci kartą wydaną w EUR:

płatnik widzi w bramce kwotę do zapłaty: 100 EUR,
realizuje płatność na 100 EUR,
w historii karty widzi płatność na 100 EUR,
akceptant otrzymuje płatność w EUR.

Płatność została zaprezentowana w wysokości 100 EUR, a płatnik płaci kartą wydaną w PLN:

płatnik widzi w bramce kwotę do zapłaty: 100 EUR,
realizuje płatność na 100 EUR,
w historii karty widzi płatność na 100 EUR oraz kwotę pobraną z karty w PLN (np. 450 PLN – przeliczenie następuje po stronie wydawcy karty płatnika),
akceptant otrzymuje płatność w EUR.

Uwaga

Zwroty w multi-currency są realizowane po kursie wymiany obowiązującym w dniu zwrotu, a nie w dniu sprzedaży – warto mieć na uwadze możliwe różnice kursowe pomiędzy dniem sprzedaży i dniem zwrotu.

Zanim zaczniesz – wymagania

Aby korzystać z płatności multi-currency:

Twój MID w Worldline musi mieć aktywowaną obsługę walut – zgłoś taką potrzebę swojemu opiekunowi Tpay w procesie onboardingu.
Tpay skonfiguruje w Twoim profilu obsługę wybranych walut transakcyjnych, zgodnie z ustaleniami z Worldline.
Merchant ID skonfigurowany do płatności w walutach powinien mieć włączone wyłącznie kanały kartowe. Jeśli na takim MID zostanie włączona inna metoda płatności, płatności tą metodą będą – dla bezpieczeństwa – odrzucane.
Płatności walutowe - inne niż PLN - wymagają oddzielnego konta merchant id w Tpay dla każdej domeny oraz dla każdej waluty rozliczeniowej z włączoną usługą DCC. W pozostałych przypadkach wystarczy jedno konto merchant id w Tpay. W przygotowaniu jest rozwiązanie pozwalające skorzystać z walut i PLN w ramach jednego merchant id w Tpay.

Uwaga

Płatności w walutach można obecnie zakładać wyłącznie przez API. Generator linków płatniczych w Panelu Akceptanta nie wspiera jeszcze walut.

Dostępne waluty transakcyjne

Dostępne są następujące waluty transakcyjne: EUR, USD oraz ALL, AMD, AUD, AZN, BAM, BRL, CAD, CHF, CNY, CZK, DKK, GBP, GEL, HUF, INR, ISK, JPY, KZT, MDD, MKD, MXN, NOK, RON, RSD, SEK, SGD, TRY, UAH, ZAR.

Jeśli potrzebujesz płatności w walucie, która nie znajduje się na powyższej liście, zgłoś taką potrzebę swojemu opiekunowi Tpay – rozszerzenie listy walut transakcyjnych jest możliwe.

Waluty rozliczeniowe

W ramach umowy z Worldline akceptant wskazuje, w jakich walutach chce przyjmować płatności oraz w jakich walutach chce otrzymywać wypłacane środki. Rozliczenie możliwe jest:

z przewalutowaniem – np. płatności w USD, EUR i GBP, a wypłata w jednej wspólnej walucie, np. EUR,
bez przewalutowania (1:1) – wypłata następuje w tej samej walucie, w jakiej przyjęto płatność, np. płatność w USD → wypłata w USD.

Wśród dostępnych walut rozliczeniowych są m.in.: EUR, USD, GBP, CHF, DKK, HUF, NOK, SEK.

Uwaga

Niezależnie od wybranego sposobu rozliczenia, wypłata w walucie może wpłynąć na konto bankowe prowadzone w np. PLN – przewalutowanie nastąpi wtedy po stronie banku odbiorcy.

Utworzenie transakcji w walucie

Płatności kartowe w walucie zakładaj wykorzystując standardowy endpoint zakładania transakcji, podając dodatkowo pole currency z kodem waluty zgodnym z ISO 4217 oraz pay.groupId: 103 (grupa płatności dla kart).

Aby utworzyć transakcję kartową w walucie, 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.
currency *	Kod waluty transakcji zgodny z ISO 4217, np. `EUR`.
description *	Opis transakcji widoczny dla płatnika.
payer.email	Adres e-mail płatnika.
payer.name	Imię i nazwisko płatnika.
pay.groupId	Identyfikator grupy płatności dla kart: 103.

* Pola obowiązkowe.

Uwaga

Jeśli nie przekażesz pola currency, transakcja zostanie założona w domyślnej walucie PLN.

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

{
  "amount": 100,
  "currency": "EUR",
  "description": "Testowa płatność kartowa w EUR",
  "payer": {
    "email": "[email protected]",
    "name": "Jan Nowak"
  },
  "pay": {
    "groupId": 103
  }
}

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.
currency	Waluta transakcji.
transactionPaymentUrl	Adres URL, na który należy przekierować płatnika.

Przykładowa odpowiedź:

{
  "result": "success",
  "requestId": "858fa92dc62db44e2c1f",
  "transactionId": "01K5BK4HEPB0WBCGT51FMTYSYJ",
  "title": "TR-CWM-CNYHA6X",
  "posId": "ps_e4dkPVDEm4Jg7267",
  "status": "pending",
  "date": {
    "creation": "2024-06-06 21:31:35",
    "realization": null
  },
  "amount": 100,
  "currency": "EUR",
  "description": "Testowa płatność kartowa w EUR",
  "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-CNYHA6X&uid=01HZQGHZP5P3P7YV8A4BRVDX17"
}

Dalszy proces – przekierowanie płatnika, uwierzytelnienie 3D Secure oraz obsługa powiadomienia – przebiega tak samo, jak dla standardowej transakcji kartowej.

Obsługiwane metody płatności

Płatności w dowolnej walucie zrealizowane będą: kartą, Apple Pay, Google Pay.

Ograniczenia obecnego rozwiązania

Transakcje w walucie można zakładać wyłącznie przez API – generator linków płatniczych nie wspiera jeszcze walut.
Transakcje w walutach spoza listy skonfigurowanej dla danego MID będą odrzucane.
MID skonfigurowany do walut kartowych powinien mieć aktywne wyłącznie kanały kartowe – inne metody płatności na takim MID będą odrzucane.
Płatność Click to Pay nie wspiera obecnie walut.

Obsłuż powiadomienie

Poinformujemy Ciebie o statusie transakcji za pośrednictwem notyfikacji po zaksięgowaniu transakcji. Notyfikacja zawiera pole currency z walutą transakcji.