- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plățile Multibanco
Multibanco
Multibanco este o metodă de plată utilizată în Portugalia. Multibanco permite consumatorilor să plătească pentru diferite bunuri și servicii, cum ar fi comerțul electronic, permisele și taxele fie prin transfer bancar, fie folosind cardul Multibanco la un ATM.
Multibanco este o metodă de plată prin browser acceptată în Mastercard Gateway. Această pagină descrie detaliile integrării specifice metodei Multibanco. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea integrarea Multibanco.
Plățile prin browser Multibanco sunt acceptate numai pentru tranzacțiile în moneda EUR.
Cerințe preliminare
Pentru a oferi Multibanco ca metodă de plată prin 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 ș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 Multibanco
Integrarea Hosted Checkout vă permite să colectați detalii de plată de la plătitorii dvs., prin intermediul unei interacțiuni găzduite și afișate de gateway.
Începând cu versiunea API 65, Multibanco este automat disponibil ca metodă de plată odată ce your payment service provider activează și configurează această metodă de plată pentru dvs.
Pentru detalii, consultați Plățile prin browser în integrarea Hosted Checkout.
Integrarea Direct Payment vă permite să oferiți metoda de plată Multibanco pe propria dvs. pagină de validare.
Efectuați o solicitare Initiate Browser Payment unde sourceOfFunds.type = MULTIBANCO și browserPayment.operation = PAY (operațiunea Authorize nu este acceptată de către Multibanco). Pentru câmpurile standard, consultați Plățile prin browser în integrarea Direct Payment.
După inițierea unei plăți Multibanco, următoarele câmpuri sunt returnate în răspunsul Initiate Browser Payment/Retrieve Transaction/Retrieve Order.
sourceOfFunds.provided.multibanco.entityId: Identificatorul dvs. de comerciant de la Multibanco.sourceOfFunds.provided.multibanco.paymentReference: Un identificator pentru plata Multibanco.
Trebuie să furnizați aceste câmpuri plătitorului pentru ca acesta să finalizeze plata.
Limba preferată
Puteți seta limba în care doriți ca serviciul Multibanco 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 Multibanco.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"order":{
"amount":"10.00",
"currency":"EUR"
},
"sourceOfFunds":{
"type":"MULTIBANCO"
}
}
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 Multibanco.
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.multibanco.terminalLocationsourceOfFunds.provided.multibanco.terminalId |
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ă. Gateway-ul va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
Testarea integrării
Mastercard Gateway furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea Multibanco.