Płatności ratalne kartą

Tylko dla rynku rumuńskiego

Płatności ratalne kartą są formą płatności przeznaczoną dla rynku rumuńskiego. Jeśli jesteś zainteresowany tą formą płatności, skontaktuj się z przedstawicielem PayU.

PayU wspiera płatności ratalne kartami tylko dla rynku Rumuńskiego, pozwalając kupującym na podział całkowitej kwoty zamówienia na kilka rat. Ta funkcjonalność pomaga sprzedawcom zwiększyć wskaźniki konwersji, oferując elastyczne opcje płatności, jednocześnie zapewniając, że tylko ważne plany ratalne są prezentowane kupującym na podstawie szczegółów ich karty.

Możesz oferować płatności ratalne zarówno podczas wysyłania zamówień z własnej strony płatności, jak i podczas korzystania ze strony płatniczej PayU.

W przypadku wysyłania zamówienia z własnej strony płatności, najpierw pobierz dostępny plan ratalny oraz liczbę dostępnych rat na podstawie numeru BIN karty. Aby uzyskać dane dotyczące rat dla konkretnego numeru BIN karty, skorzystaj z dedykowanego API lub pobierz te informacje, włączając odpowiednią opcję w Secure Form.

W przypadku płatności realizowanych za pośrednictwem strony płatności PayU, możesz skonfigurować filtry, aby ograniczyć dostępne opcje ratalne w ramach konkretnych programów. Po wprowadzeniu numeru BIN karty przez kupującego do formularza, zobaczy on dostępne opcje ratalne dla swojej karty.

Nowe zamówienie z Twojej strony płatności

W przypadku wysyłania zamówienia z własnej strony płatności, opcje ratalne mogą być wykorzystywane niezależnie od tego, czy korzystasz z Secure Form, czy nie. Jednak przed złożeniem zamówienia musisz pobrać dostępne opcje ratalne dla konkretnego numeru BIN karty.

Pobieranie dostępnych opcji ratalnych

Możesz pobrać dostępne opcje ratalne na dwa sposoby, za pomocą:

• Secure Form,
• lub API (jeśli nie używasz formularza zabezpieczającego)

Pobierane opcji ratalnych poprzez Secure Form

Aby pobrać dostępne opcje ratalne podczas korzystania z Secure Form, musisz ustawić flagę "enableInstallments": true w opcjach kart podczas inicjowania formularza.

Przykład opcji Secure Form

{
  "style": {
    "basic": {
      "fontSize": "18px"
    }
  },
  "enableInstallments": true
}

Kiedy użytkownik wprowadzi pierwsze 10 cyfr numeru BIN swojej karty, zostanie wywołane zdarzenie installmentsChange. Ciało zdarzenia będzie zawierać dostępny plan ratalny oraz dozwoloną liczbę rat dla podanego numeru BIN.

Przykład ciała zdarzenia

{
  "numbers": [1, 2, 4, 6, 8, 12],
  "provider": "BRD_INSTALLMENTS",
  "settings": {
    "minAmount": 60000
  }
}

Sekcja settings

Obiekt settings jest opcjonalny. Obecnie, określa on minAmount dla danego planu ratalnego. Jeśli uwzględnisz dane ratalne w zamówieniu, ale całkowita kwota zamówienia jest równa lub niższa niż zdefiniowana wartość minAmount, zamówienie zostanie odrzucone.

Jesteś odpowiedzialny za wyświetlenie odpowiedniego formularza, który pozwoli użytkownikowi wybrać

Pobieranie opcji ratalnych poprzez API

Jeżeli nie używasz Secure Form, musisz pobrać dane dotyczące rat kartowych za pomocą API: /api/front/card-installments-options. Ciało żądania musi zawierać co najmniej pierwsze 10 cyfr numeru BIN karty oraz Twój identyfikator POS.

Przykład ciała żądania dla pobierania opcji ratalnych za pomocą API

{
  "cardBin": "5364477839",
  "posId": "pg203018"
}

Przykład odpowiedzi

{
  "numbers": [1, 6, 12, 20, 21, 22, 23, 24],
  "provider": "BRD_INSTALLMENTS",
  "settings": {
    "minAmount": 60000
  }
}

Sekcja settings

Obiekt settings jest opcjonalny. Obecnie, określa on minAmount dla danego planu ratalnego. Jeśli uwzględnisz dane ratalne w zamówieniu, ale całkowita kwota zamówienia jest równa lub niższa niż zdefiniowana wartość minAmount, zamówienie zostanie odrzucone.

Tworzenie zamówienia z opcjami ratalnymi

Aby utworzyć zamówienie i przetworzyć płatność, musisz uwzględnić sekcję cardInstallments w obiekcie payMethod w ciele żądania. Płatność musi być realizowana za pomocą tokena karty.

Przykład sekcji payMethods dla tworzenia zamówienia z opcjami ratalnymi

{
  "payMethods": {
    "payMethod": {
      "amount": 245,
      "currencyCode": "RON",
      "type": "CARD_TOKEN",
      "value": "TOKC_TB4P9IBWFOCOUS1REDFK75S1XCK",
      "cardInstallments": {
        "provider": "STAR_BT",
        "number": 12
      }
    }
  }
}

Tworzenie zamówienia ze strony płatniczej PayU

Jeśli używasz strony płatniczej PayU do obsługi płatności, strona automatycznie wyświetla dostępne opcje ratalne po tym, jak kupujący wprowadzi pierwsze 10 cyfr numeru BIN swojej karty (Bank Identification Number).

Możesz jednak filtrować dostępne opcje ratalne w ramach konkretnych programów. Aby to zrobić, dodaj sekcję cardInstallmentsOptions do obiektu settings. Gdy filtry dla danego programu zostaną zdefiniowane, wyświetlane opcje będą reprezentować część wspólną dostępnych rat dla podanego BIN i skonfigurowanych filtrów.

Przykład żądania z filtrowanymi opcjami

{
  "settings": {
    "cardInstallmentsOptions": {
      "ALPHABANK_INSTALLMENTS": [1, 3, 5, 7, 9, 11, 13],
      "RAIFFEISEN": [1, 6, 12],
      "STAR_BT": [6, 20, 21]
    }
  }
}