- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plățile paysafecard
paysafecard
paysafecard este o metodă de plată electronică preplătită disponibilă în numeroase țări și limbi. Plătitorii cumpără un voucher paysafecard din magazine sau dintr-un magazin PIN online autorizat. Voucherul paysafecard conține un PIN din 16 cifre. Ca alternativă, dacă plătitorii dețin un cont mypaysafecard, atunci când sunt redirecționați către pagina web a paysafecard, pot alege să se conecteze la contul lor mypaysafecard și să aprobe plata.
Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea integrarea paysafecard.
Cerințe preliminare
Pentru a oferi metoda de plată paysafecard prin <<paymentGateway>>:
- trebuie să vă înregistrați la furnizorul dvs. de servicii de plată prin browser,
- profilul dvs. de comerciant de pe <<paymentGateway>> trebuie configurat cu detaliile contului dvs. de la furnizorul de servicii de plată prin browser,
- trebuie să aveți un cont paysafecard sau un voucher într-una dintre monedele acceptate, asociat contului dvs. de comerciant de la furnizorul de servicii de plată prin browser.
Tranzacții paysafecard
Achizitorii PPRO acceptă tranzacțiile paysafecard care își au originea din țările și monedele corespunzătoare menționate în tabelul de mai jos.
| Țara | Moneda |
|---|---|
| Australia (AUS) | AUD |
| Austria (AUT) | EUR |
| Belgia (BEL) | EUR |
| Bulgaria (BGR) | EUR |
| Canada (CAN) | CAD |
| Croația (HRV) | EUR |
| Cipru (CYP) | EUR |
| Republica Cehă (CZE) | EUR |
| Danemarca (DNK) | EUR |
| Finlanda (FIN) | EUR |
| Franța (FRA) | EUR |
| Germania (DEU) | EUR |
| Georgia (GEO) | EUR |
| Gibraltar (GIB) | EUR |
| Grecia (GRC) | EUR |
| Ungaria (HUN) | EUR |
| Irlanda (IRL) | EUR |
| Italia (ITA) | EUR |
| Liechtenstein (LIE) | EUR |
| Lituania (LTU) | EUR |
| Luxemburg (LUX) | EUR |
| Malta (MLT) | EUR |
| Mexico (MEX) | USD |
| Noua Zeelandă (NLD) | EUR |
| Țările de Jos (NOR) | NOK |
| Norvegia (NZL) | EUR |
| Peru (PER) | EUR |
| Polonia (POL) | PLN |
| Portugalia (PRT) | EUR |
| România (ROU) | RON |
| Slovenia (SVN) | EUR |
| Slovacia (SVK) | EUR |
| Spania (ESP) | EUR |
| Elveția (CHE) | CHF |
| Suedia (SWE) | SEK |
| Regatul Unit (GBR) | GBP |
| Uruguay (URY) | EUR |
Integrarea paysafecard
Integrarea <<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 <<paymentGateway>>.
Începând cu versiunea API 70, paysafecard este automat disponibil ca metodă de plată odată ce <<paymentServiceProvider>> activează și configurează această metodă de plată pentru dvs.
Pentru detalii, consultați Plățile prin browser în integrarea <<checkout>>.
Integrarea <<directPayment>> vă permite să oferiți metoda de plată paysafecard pe propria dvs. pagină de validare.
Câmpuri comune
În plus față de câmpurile standard obligatorii într-o solicitare de plată prin browser, trebuie să completați următoarele câmpuri obișnuite în solicitarea Initiate Browser Payment:
sourceOfFunds.type-PAYSAFECARDbrowserPayment.operation-PAYcustomer.account.id-The ID, username, hash, or anything used to identify the consumer.sourceOfFunds.provided.paysafecard.countryCode‑Detalii suplimentare legate de plata paysafecard prin browser.sourceOfFunds.provided.paysafecard.accountEmail-The mypaysafecard account email identifies the mypaysafecard account that will be refunded.
Limba preferată
Puteți seta limba în care doriți ca serviciul paysafecard 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 paysafecard.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com"
},
"order": {
"amount": "142.22",
"currency": "PLN"
},
"sourceOfFunds": {
"type": "PAYSAFECARD",
"provided": {
"paysafecard": {
"countryCode": "POL"
}
}
}
}
Interpretarea rezultatului tranzacției
Tabelul de mai jos prezintă codurile de răspuns la tranzacții pentru scenariile posibile care pot apărea după inițierea unei plăți paysafecard.
| 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=SUCCESS |
Plata a fost realizată cu succes. |
response.gatewayCode=PENDINGresult=PENDING |
<<paymentGateway>> 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 <<paymentGateway>>. |
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 sau 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ă. <<paymentGateway>> va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
Rambursări
Plățile paysafecard pot fi rambursate integral sau în rate. Asigurați-vă că ați configurat rambursările în <<paymentGateway>> și în contul dvs. de comerciant de la furnizorul de servicii de plată prin browser.
Rambursările pentru plățile paysafecard sunt posibile doar dacă plătitorii au un cont mypaysafecard. Dacă plătitorii nu au un cont paysafecard sau dacă sunt dintr-o țară în care conturile mypaysafecard nu sunt disponibile și sunt acceptate doar plățile prin voucherul paysafecard, trebuie să oferiți plătitorilor rambursarea printr-o metodă de plată diferită, de exemplu, prin card.
Testarea integrării
<<paymentGateway>> furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea paysafecard.