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.
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.
Upewnij się, że:
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ł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:
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.
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:
Ograniczenia
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.
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.
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łatność została zaprezentowana w wysokości 100 EUR, a płatnik płaci kartą wydaną w PLN:
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.
Aby korzystać z płatności multi-currency:
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 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.
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:
Wśród dostępnych walut rozliczeniowych są m.in.: EUR, USD, GBP, CHF, DKK, HUF, NOK, SEK.
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.
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.
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.
Płatności w dowolnej walucie zrealizowane będą: kartą, Apple Pay, Google Pay.
Poinformujemy Ciebie o statusie transakcji za pośrednictwem notyfikacji po zaksięgowaniu transakcji. Notyfikacja zawiera pole currency z walutą transakcji.