Visa Mobile

Visa Mobile to cyfrowy portfel, który umożliwia użytkownikom powiązanie karty Visa z numerem telefonu za pomocą aplikacji mobilnej. Dzięki temu użytkownicy mogą dokonywać płatności online, używając tylko swojego numeru telefonu, a transakcje są potwierdzane przez aplikację.

Usługa Visa Mobile jest dostępna bezpośrednio na stronie płatniczej PayU, co nie wymaga żadnych zmian w integracji z PayU i działa po prostu jako dodatkowa metoda płatności dla użytkowników.

Możliwe jest również inicjowanie płatności Visa Mobile bezpośrednio na stronie płatniczej PayU. Alternatywnie, można pominąć stronę płatniczą PayU, wysyłając żądanie poprzez API. W takim przypadku cały proces interakcji użytkownika odbywa się na stronie sklepu.

Oficjalna strona Visa Mobile

Dodatkowe informacje na temat Visa Mobile można znajdziesz na oficjalnej stronie internetowej Visa.

Jak działa Visa Mobile?

Usługa Visa Mobile działa zgodnie z następującymi krokami:

1. Płatnik wybiera opcję płatności Visa Mobile i wprowadza swój numer telefonu.
2. (Opcjonalnie) Płatnik potwierdza swoje dane na stronie internetowej sklepu.
3. Płatnik składa zamówienie i dokonuje płatności.
4. Płatnik potwierdza płatność w swojej aplikacji bankowej lub aplikacji Visa Mobile.
5. Po potwierdzeniu płatności PayU rozpoczyna przetwarzanie transakcji przy użyciu karty powiązanej z portfelem Visa Mobile.
6. Wynik przetwarzania transakcji jest przekazywany do sklepu.

Tworzenie zamówienia z Visa Mobile

W PayU dostępne są trzy ścieżki płatności z wykorzystaniem Visa Mobile:

• przekierowanie płatnika na stronę płatności PayU,
• przekierowanie płatnika na stronę płatności PayU z wybraną opcją Visa Mobile
• przetworzenie transakcji bez przekierowania na stronę płatności PayU.

Visa Mobile - Przekierowanie na stronę płatności PayU

Aby umożliwić użytkownikowi wybranie opcji płatności Visa Mobile, wystarczy rozpocznij transakcję, postępując zgodnie z wytycznymi na stronie Przyjmowanie płatności.

Visa Mobile - Przekierowanie do strony płatności PayU z wybraną metodą płatności

Aby bezpośrednio przekierować użytkownika do opcji płatności Visa Mobile na stronie płatności PayU, rozszerz standardowe żądanie zamówienia o obiekt payMethods:

{
  "payMethods": {
    "payMethod": {
      "type": "PBL",
      "value": "vm"
    }
  }
}

Visa Mobile - wysyłanie zamówień ze strony sklepu

To rozwiązanie wymaga wykonywania płatności za pośrednictwem własnej strony płatności. Aby obciążyć kartę powiązaną z kontem Visa Mobile, należy dołączyć rozszerzony obiekt payMethods do żądania płatności. Obiekt payMethod powinien zawierać pole authorizationCode, którego wartością jest numer telefonu zarejestrowany w Visa Mobile. Upewnij się, że numer telefonu zawiera kod kraju i składa się wyłącznie z cyfr.

{
  "payMethods": {
    "payMethod": {
      "type": "PBL",
      "value": "vm",
      "authorizationCode": "48123456789"
    }
  }
}

Transakcja jest dalej przetwarzana za pośrednictwem aplikacji Visa Mobile, gdzie użytkownik finalizuje transakcję.

Sprawdzenie rejestracji numeru w Visa Mobile

Dostępność funkcjonalności

Funkcjonalność sprawdzenia rejestracji numeru telefonu w usłudze Visa Mobile nie jest od razu dostępna. Włączenie tej funkcjonalności wymaga zgody po stronie PayU. Dodatkowo Merchant musi potwierdzić numer telefonu klienta. Wcześniejsza próba skorzystania z usługi zakończy się niepowodzeniem.

Aby zweryfikować numer telefonu w usłudze Visa Mobile, najpierw wygeneruj token uwierzytelniający OAuth. Następnie wyślij żądanie POST z numerem telefonu klienta na endpoint: https://secure.payu.com/api/v2_1/paytypes/vm/verify-phone-registration.

Przykład żądania sprawdzenia rejestracji numeru telefonu w Visa Mobile

curl -X POST https://secure.payu.com/api/v2_1/paytypes/vm/verify-phone-registration \
-H "Content-Type: application/json" \
-H "Authorization: Bearer 3e5cac39-7e38-4139-8fd6-30adc06a61bd" \
-d '
  {
    "phoneNumber": "48123123123"
  }'

Notatka

Parametr phoneNumber musi być numerem telefonu klienta, potwierdzonym przez sprzedawcę, składającym się z samych cyfr i zawierającym kod kraju.

HTTP 200 SUCCESS

W odpowiedzi zwrócona zostanie informacja, czy numer telefonu jest zarejestrowany w usłudze Visa Mobile.

{
  "exists": true
}

HTTP 401 UNAUTHORIZED

Jeżeli funkcjonalość nie jest włączona dla danego POS, zwrócona zostanie odpowiedź z kodem błędu UNAUTHORIZED.

{
  "statusCode": "UNAUTHORIZED",
  "statusDesc": "Phone checking disabled for given pos"
}

Testowanie Visa Mobile

Metoda płatności Visa Mobile jest również dostępna w środowisku Sandbox. Możesz przetestować różne scenariusze testowe, zmieniając numer kierunkowy numeru telefonu:

Numery kierunkowe dostępne w celach testowych Visa Mobile

Numer Kierunkowy	Zachowanie
40	Transakcja została uwierzytelniona za pośrednictwem aplikacji Visa Mobile, ale płatność nie powiodła się.
48	Transakcja została uwierzytelniona za pośrednictwem aplikacji Visa Mobile, płatność powiodła się.
49	Transakcja nie została uwierzytelniona przez płatnika za pośrednictwem aplikacji Visa Mobile.
52	Transakcja nie została uwierzytelniona w aplikacji Visa Mobile - przekroczenie limitu czasu (timeout).
53	Numer telefonu klienta nie jest zarejestrowany w Visa Mobile, usługa sprawdzenia numeru telefonu zwróci false.

Kody błędów Visa Mobile

Kody błędów zwracane przez usługę Visa Mobile.

Status HTTP	Kod Statusu	Opis Statusu	Opis
400 Bad Request	ERROR_VALUE_INVALID	Invalid phone number provided as authorization code.	Podany numer telefonu jest nieprawidłowy. Sprawdź czy numer składa się z samych cyfr i czy ma odpowiednią długość.
400 Bad Request	ERROR_VALUE_INVALID	Order without buyer email.	Nie podano maila płatnika lub jest on pusty.
401 UNAUTHORIZED	UNAUTHORIZED	Phone checking disabled for given pos.	Funkcjonalnośc sprawdzenia rejestracji numeru telefonu w Visa Mobile nie jest dostępna.