Ropay

Ropay to metoda płatności obsługująca przepływy oparte na kodach QR (na komputerach stacjonarnych) oraz deeplinkach (na urządzeniach mobilnych). Oferuje różne opcje integracji — od strony płatności PayU po w pełni transparentny/osadzony proces wyboru metody płatności kontrolowany przez sprzedawcę.

Konfiguracja i użycie

Podstawowe informacje

Ropay jest dostępny wyłącznie dla sprzedawców działających w Rumunii.

---

Aby włączyć Ropay po stronie PayU, skontaktuj się z zespołem sprzedaży PayU.

Gdy Ropay zostanie skonfigurowany i aktywowany, będzie on widoczny na stronie płatności (checkout).

Przepływy płatności

Ropay obsługuje dwa przepływy użytkownika w zależności od urządzenia:

• Przepływ stacjonarny (Desktop flow): Użytkownik, za pomocą aplikacji bankowości mobilnej, skanuje kod QR.
• Przepływ mobilny (Mobile flow): Użytkownik jest przekierowywany (za pomocą deeplinka) do aplikacji bankowości mobilnej, aby dokończyć płatność.

Dostępność opcji kodu QR

Opcja z kodem QR jest dostępna tylko w przepływie stacjonarnym.

Integracja sprzedawcy

Sprzedawca może korzystać z Ropay na trzy sposoby:

• Użytkownik wybiera metodę płatności na stronie wyboru płatności PayU.
• Użytkownik wybiera metodę płatności na stronie płatności sprzedawcy.
• Sprzedawca korzysta z rozwiązania white-label/osadzenia, mając pełną kontrolę nad doświadczeniem płatności.

Strona wyboru płatności PayU

Standardowa integracja, taka sama jak w przypadku innych metod płatności.

Sprzedawca tworzy zamówienie, wskazując PAYMENT_WALL w sekcji payMethod, lub pomija sekcję payMethod całkowicie:

"payMethod": {
  "type": "PAYMENT_WALL"
}

Strona płatności sprzedawcy

Użytkownik wybiera ikonę Ropay na stronie płatności sprzedawcy, a sprzedawca deklaruje ropay w żądaniu zamówienia, podobnie jak w przypadku innych metod płatności PayU:

"payMethod": {
  "type": "PBL",
  "value": "ropay"
}

W odpowiedzi sprzedawca otrzymuje redirectUri, a użytkownik jest następnie przekierowywany tak jak w standardowym procesie płatności PayU z uprzednio wybraną metodą Ropay.

Rozwiązanie white-label/osadzenie

Te opcja pozwala na pełną kontrolę nad doświadczeniem płatności, a użytkownik nie musi opuszczać strony płatności sprzedawcy aby dokończyć proces płatności. Sprzedawca jest odpowiedzialny za obsługę płatności na podstawie szczegółów zwróconych w odpowiedzi podczas tworzenia zamówienia.

W zależności od scenariusza, sprzedawca decyduje, jak użytkownik zostanie przekierowany:

• Poprzez wyświetlenie kodu QR (scenariusz stacjonarny), lub
• wywołanie przekierowania do aplikacji bankowości mobilnej (scenariusz mobilny).

PayU dostarcza niezbędne dane w odpowiedzi, podczas gdy ostateczna implementacja i doświadczenie użytkownika są kontrolowane przez sprzedawcę.

Przepływ stacjonarny

Żądanie dla trybu stacjonarnego — w odpowiedzi zostanie zwrócony kod QR:

"payMethods": {
  "payMethod": {
    "type": "TRANSPARENT",
    "value": "ropay"
  }
}

W tym trybie odpowiedź zawiera obraz kodu QR zakodowany w formacie base64:

{
  "status": {
    "statusCode": "WARNING_CONTINUE_QRCODE",
    "severity": "WARNING"
  },
  "orderId": "WZHF5FFDRJ140731GUEST000P01",
  "qrCode": "iVBORw0KGgoAAAANSUhEUgAAAJEAAACRAQAAAADro2eOAAACW0lEQVR42r2Wsa30IBCE1yIgsxtAog0yWrIbsH0N2C05ow0kGjhnBMj7Blt3L"
}

Przepływ mobilny

Żądanie dla trybu mobilnego — w odpowiedzi zostanie zwrócony adres URL przekierowania (deeplink) do aplikacji bankowości mobilnej. Aby wskazać kod Swift w tym typie integracji, sprzedawca musi przygotować własną stronę wyboru banku.

"payMethods": {
  "payMethod": {
    "type": "TRANSPARENT",
    "value": "ropay",
    "ropay": {
      "swiftCode": "ABCD1234"
    }
  }
}

Odpowiedź będzie zawierać redirectUri z deeplinkiem do uruchomienia aplikacji bankowości mobilnej:

Przykładowa odpowiedź z redirectUri

{
  "status": {
    "statusCode": "SUCCESS"
  },
  "redirectUri": "{deeplink_for_waking_up_mobile_bank_app}",
  "orderId": "WZHF5FFDRJ140731GUEST000P01"
}