- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plățile iDEAL
iDEAL
iDEAL este un serviciu de plăți pentru comerțul electronic utilizat în Olanda, care permite plătitorilor să efectueze achiziții folosind transferuri directe online din conturile lor bancare. Plătitorii sunt redirecționați către site-ul web de banking online al băncii lor, pe care pot iniția un transfer bancar instantaneu.
iDEAL este o metodă de plată prin browser acceptată în Mastercard Gateway. Această pagină descrie detaliile integrării specifice iDEAL. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare iDEAL.
Plățile prin browser iDEAL sunt acceptate numai pentru tranzacțiile în moneda EUR.
Cerințe preliminare
Pentru a oferi iDEAL ca metodă de plată în Mastercard Gateway:
- Trebuie să vă înregistrați la furnizorul dvs. de servicii de plată prin browser.
- Profilul dvs. de comerciant de pe gateway trebuie configurat cu detaliile contului dvs. de la furnizorul de servicii de plată prin browser.
- 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 iDEAL
În cazul integrărilor Hosted Checkout versiunea 50 și versiunile ulterioare, iDEAL va fi automat disponibil pentru plătitorii dvs. după ce your payment service provider configurează și activează cu succes serviciul.
Pentru detalii, consultați Plățile prin browser în integrarea Hosted Checkout.
Integrarea Direct Payment vă permite să oferiți metoda de plată iDEAL pe propria dvs. pagină de validare.
Î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 pentru procesarea plăților iDEAL.
sourceOfFunds.type = IDEALbrowserPayment.operation = PAY(operațiunea Authorize nu este acceptată de iDEAL).sourceOfFunds.provided.ideal.bic: Identificatorul internațional de companie (BIC) pentru contul bancar al plătitorului. Pentru o experiență optimizată a plătitorului, este recomandat să completați acest câmp. Astfel, plătitorului nu i se va afișa formularul de selectare a băncii, acesta fiind redirecționat automat către banca sa.
Limba preferată
Puteți seta limba în care doriți ca serviciul iDEAL 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 iDEAL.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"IDEAL"
}
}
Interpretarea rezultatului tranzacției
Tabelul următor prezintă codurile de răspuns la tranzacții pentru scenariile posibile care pot apărea după inițierea unei plăți iDEAL.
Răspunsul la Initiate Browser Payment |
Ce înseamnă... |
|---|---|
response.gatewayCode=SUBMITTEDresult=SUCCESS |
Redirecționați plătitorul la adresa URL inclusă în răspuns. |
Răspunsul la Retrieve Transaction/Retrieve Order |
Ce înseamnă... |
response.gatewayCode=APPROVEDresult=SUCCESSsourceOfFunds.provided.ideal.bankAccountHoldersourceOfFunds.provided.ideal.bic (dacă a fost furnizat în solicitare)
|
Plata a fost realizată cu succes. |
response.gatewayCode=PENDINGresult=PENDING |
Mastercard Gateway 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 Mastercard Gateway. |
response.gatewayCode=CANCELLEDresult=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 or ACQUIRER_SYSTEM_ERRORresult=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_OUTresult=FAILURE |
Tratați acest eveniment ca pe o plată respinsă. Mastercard Gateway va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
Rambursări
Plățile iDEAL pot fi rambursate integral sau parțial. Trebuie să configurați rambursările în Mastercard Gateway și în contul dvs. de comerciant de la furnizorul de servicii de plată prin browser.
Testarea integrării
Mastercard Gateway furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea iDEAL.