Plăți Przelewy24

Przelewy24 este o metodă de plată din Polonia care oferă transferuri bancare online în timp real, numită deseori P24. Przelewy24 este o metodă de plată prin browser acceptată în eGenius Platform. Această pagină descrie detaliile integrării specifice metodei Przelewy24.

Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare Przelewy24.

Plățile prin browser Przelewy24 sunt acceptate numai pentru tranzacțiile în monedele EUR și PLN.

Cerințe preliminare

Pentru a oferi metoda de plată Przelewy24 prin eGenius Platform:

  • trebuie să vă înregistrați la furnizorul dvs. de servicii de plată prin browser
  • profilul dvs. de comerciant de pe Mastercard Payment Gateway trebuie configurat cu detaliile contului dvs. de la furnizorul de servicii de plată prin browser și
  • trebuie să aveți un cont bancar într-una dintre monedele acceptate, asociat contului dvs. de comerciant de la furnizorul de servicii de plată prin browser.

Integrarea Przelewy24

Przelewy24 prin Hosted Checkout

Integrarea Hosted Checkout vă permite să colectați detalii de plată de la plătitor, prin intermediul unei interacțiuni găzduite și afișate de către eGenius Platform.

Începând cu versiunea API 65, Przelewy24 este automat disponibil ca metodă de plată odată ce furnizorul de servicii de plată activează și configurează această metodă de plată pentru dvs.

Pentru detalii, consultați Plățile prin browser în integrarea Hosted Checkout.

Przelewy24 prin Direct Payment

Integrarea Direct Payment vă permite să oferiți metoda de plată Przelewy24 pe propria dvs. pagină de validare.

Przelewy24 este acceptat începând din versiunea 64 a API.

În plus față de câmpurile standard obligatorii într-o solicitare de plată prin browser, trebuie să completați următoarele câmpuri în solicitarea Initiate Browser Payment:

Câmpuri comune

  • sourceOfFunds.type = Przelewy24
  • browserPayment.operation = PAY (Przelewy24 does not support the Authorize operation)
  • customer.email = Email address of a payer
  • sourceOfFunds.provided.przelewy24.bankAccountHolder= Numele posesorului contului bancar al plătitorului

Limba preferată

Puteți seta limba în care doriți ca serviciul Przelewy24 să afișeze paginile pentru plătitor, completând câmpul browserPayment.preferredLanguage din solicitarea Initiate Browser Payment. Limba va fi utilizată, însă, numai dacă este acceptată de Przelewy24.

Exemplu de cod pentru inițierea plăților Przelewy24
{
    "apiOperation": "INITIATE_BROWSER_PAYMENT",
    "billing": {
        "address": {
            "country": "POL"
        }
    },
    "browserPayment": {
        "operation": "PAY",
        "returnUrl": "<your_merchant_URL>"
    },
    "customer": {
        "email": "john.smith@example.com"
    },
    "order": {
        "amount": 100,
        "currency": "PLN"
    },
    "sourceOfFunds": {
        "type": "PRZELEWY24",
        "provided": {
            "przelewy24": {
                "bankAccountHolder": "Test Tester"
            }
        }
    }
}

Interpretarea rezultatului tranzacției

Tabelul prezintă codurile de răspuns la tranzacții pentru scenariile posibile care pot apărea după inițierea unei plăți Przelewy24.

Răspunsul la Initiate Browser Payment Ce înseamnă...
response.gatewayCode=SUBMITTED
result=SUCCESS		 Redirecționați plătitorul la adresa URL inclusă în răspuns.
Răspunsul la Retrieve Transaction/Retrieve Order Ce înseamnă...
response.gatewayCode=APPROVED
result=SUCCESS		 Plata a fost realizată cu succes.
response.gatewayCode=PENDING
result=PENDING		 eGenius Platform așteaptă o notificare de la achizitor privind rezultatul plății. Încercați RETRIEVE_TRANSACTION din nou mai târziu sau urmăriți notificările de pe eGenius Platform.
response.gatewayCode=CANCELLED
result=FAILURE		 Plătitorul a revocat interacțiunea pentru plata respectivă. Oferiți plătitorului opțiunea de a încerca o altă metodă de plată.
response.gatewayCode=DECLINED sau ACQUIRER_SYSTEM_ERROR
result=FAILURE		 Plata a fost respinsă. Oferiți plătitorului opțiunea de a încerca o altă metodă de plată. În cazul unui ACQUIRER_SYSTEM_ERROR, poate fi util să solicitați achizitorului motivul pentru eșecul plății sau puteți încerca RETRIEVE_TRANSACTION din nou.
response.gatewayCode=TIMED_OUT
result=FAILURE		 Tratați acest eveniment ca pe o plată respinsă. eGenius Platform va încerca să se asigure că tranzacția nu a avut succes sau o va anula.

Rambursări

Plățile Przelewy24 pot fi rambursate integral sau în rate. Asigurați-vă că ați configurat rambursările pe Mastercard Payment Gateway și în contul dvs. de comerciant de la furnizorul de servicii de plată prin browser.

Testarea integrării

eGenius Platform furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea Przelewy24.

Copyright © 2023 UniCredit Bank