Płać w ratach z Mastercard

Merchant bezpośrednio zintegrowany ze stroną płatniczą PayU, w celu udostępnienia płacącemu usługi "Płać w ratach z Mastercard" nie musi wykonywać żadnych dodatkowych akcji.

Kliknij przycisk - zostaniesz przekierowany na stronę płatniczą PayU.

Do płatności użyj karty z tabeli Karty na środowisku sandbox z wartością "tak" w kolumnie "Raty Mastercard". Na stronie ze satusem płatności kliknij przycisk Rozkładam na raty.

W tym celu powinieneś pobrać dane o transakcji utworzonej do danego zamówienia. Jeśli płatność może zostać rozłożona na raty to w sekcji card pojawi się sekcja cardInstallmentProposal z indentyfikatorem propozycji ratalnej proposalId.

W przypadku gdy płatność może zostać rozłożona na raty należy zaoferować płacącemu taką możliwość.

Propozycja ratalna na środowisku Sandbox nie jest powiązana z kwotą zamówienia i zawsze zwraca dane dla kwoty 480 PLN.

Aby pobrać propozycję ratalną powinieneś wysłać żądanie GET na adres /api/v2_1/card-installment-proposals/{proposalId}

Odpowiedz będzie zawierała propozycję ratalną z opcjami w jednym z dwóch możliwych formatów:

• VARYING_NUMBER_OF_OPTIONS – format z wieloma opcjami ratalnymi (od 1 do 12), z możliwością wyboru jednej z opcji;
• VARYING_NUMBER_OF_INSTALLMENTS – format z jedną opcją ratalną, z możliwością wyboru liczby rat.

Uwagi:

Przykłady dla zamówienia o wartosci 480 PLN:

• Format z wieloma opcjami ratalnymi (VARYING_NUMBER_OF_OPTIONS):

{
  "id": "2bd92572-d32f-4aa8-b486-be51629811e5",
  "cardScheme": "MC",
  "installmentOptionFormat": "VARYING_NUMBER_OF_OPTIONS",
  "currencyCode": "PLN",
  "installmentOptions": [
    {
      "id": "1",
      "interestRate": 5.4,
      "installmentFeeAmount": 1000,
      "annualPercentageRate": 17.93,
      "totalAmountDue": 49440,
      "firstInstallmentAmount": 16480,
      "installmentAmount": 16480,
      "numberOfInstallments": 3
    },
    {
      "id": "2",
      "interestRate": 5.2,
      "installmentFeeAmount": 1100,
      "annualPercentageRate": 13.05,
      "totalAmountDue": 49848,
      "firstInstallmentAmount": 8308,
      "installmentAmount": 8308,
      "numberOfInstallments": 6
    },
    {
      "id": "3",
      "interestRate": 5,
      "installmentFeeAmount": 1200,
      "annualPercentageRate": 9.64,
      "totalAmountDue": 50544,
      "firstInstallmentAmount": 4344,
      "installmentAmount": 4200,
      "numberOfInstallments": 12
    }
  ]
}
                

• Format z jedną opcją ratalną (VARYING_NUMBER_OF_INSTALLMENTS):

{
  "id": "9c0d357d-7f78-42d2-898b-1fc9b528ac63",
  "cardScheme": "MC",
  "installmentOptionFormat": "VARYING_NUMBER_OF_INSTALLMENTS",
  "currencyCode": "PLN",
  "minNumberOfInstallments": 6,
  "maxNumberOfInstallments": 12,
  "installmentOptions": [
    {
      "id": "1",
      "interestRate": 0,
      "installmentFeeAmount": 0,
      "annualPercentageRate": 0,
      "totalAmountDue": 48000
    }
  ]
}
                

W przypadku uzyskania odpowiedzi, która zawiera sekcje installmentDecision zamiast wyświetlać opcje ratalne należy poinformować płacacego, że wniosek o rozłożenie płatności na raty został przekazany do banku wydawcy karty. W przypadku dodatkowych pytań płacący powinien skontaktować się bezpośrednio z bankiem wydawcy karty w kolejnym dniu roboczym.

Na dokonanie wyboru opcji ratalnej płacący ma 15 minut.

W celu odesłania decyzji płacącego powinieneś wysłać żądanie POST na adres /api/v2_1/card-installment-proposals/{proposalId}/decisions, które zawiera w body komunikatu informacje jednoznacznie identyfikujące wybraną opcje:

{
  "optionId": "2",          // opcjonalne, wymagane dla formatu VARYING_NUMBER_OF_OPTIONS
  "numberOfInstallments": 9 // opcjonalne, wymagane dla formatu VARYING_NUMBER_OF_INSTALLMENTS
}
                

Decyzja płacącego jest widoczna w sekcji installmentDecision po ponownym pobraniu propozycji ratalnej:

{
  "id": "5aff3ba8-0c37-4da1-ba4a-4ff24bcc2eed",
  (...)
  "installmentDecision": {
    "optionId": "3",
    "numberOfInstallments": 12,
    "createTime": "2021-03-05T12:58:14.828+01:00"
  }
}
                

W przypadku uzyskania w odpowiedzi kodu powodzenia (HTTP 204 - NO CONTENT) powinieneś poinformować płacacego, że wniosek o rozłożenie płatności na raty został przekazany do banku wydawcy karty. W przypadku dodatkowych pytań płacący powinien skontaktować się bezpośrednio z bankiem wydawcy karty w kolejnym dniu roboczym.

W przypadku uzyskania w odpowiedzi kodu błędu powinieneś poinformować płacącego, że wniosek o rozłożenie płatności na raty nie został przekazany do banku wydawcy karty. Jednakże płatność zakończyła się sukcesem i karta zostanie obciążona pełną kwotą zamówienia. Możliwe kody błędów można znaleźć poniżej.

Następujący komunikat błędu zostanie zwrócony w przypadku próby pobrania możliwych opcji ratalnych lub odesłania decyzji płacącego dla nieistniejącej propozycji ratalnej:

Poniższa tabela przedstawia możliwe błędy wraz z ich opisem: