- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plățile SEPA
SEPA
SEPA este un serviciu de plăți pentru comerțul electronic utilizat în zona Euro, care permite plătitorilor să efectueze achiziții folosind plăți prin debitare directă din conturile lor bancare. Plătitorii sunt redirecționați către PPRO, iar plătitorul acceptă mandatul afișat pe ecran, ceea ce declanșează o pre-notificare de plată prin e-mail și debitarea plății din contul plătitorului.
SEPA este o metodă de plată prin browser acceptată în Payment Gateway. Această pagină descrie detaliile integrării specifice SEPA. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare SEPA.
Plățile prin browser SEPA sunt acceptate numai pentru tranzacțiile în moneda EUR.
Cerințe preliminare
Pentru a oferi SEPA ca metodă de plată în Payment 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 SEPA
Serviciul SEPA va fi disponibil în curând prin Hosted Checkout. Vă rugăm să contactați your payment service provider pentru mai multe informații.
Integrarea Direct API vă permite să oferiți metoda de plată SEPA 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:
sourceOfFunds.type=SEPAbrowserPayment.operation=PAY(operațiunea Authorize nu este acceptată de SEPA)customer.email: Adresa de email a plătitorului.sourceOfFunds.provided.sepa.bankAccountHolder: Numele posesorului contului bancar al plătitorului.sourceOfFunds.provided.sepa.iban: Identificatorul internațional al contului bancar (IBAN) pentru contul bancar al plătitorului.
Limba preferată
Puteți seta limba în care doriți ca serviciul SEPA 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 SEPA.
Rambursările
Plățile SEPA prezintă riscul de rambursare. Dacă un plătitor dispută o plată și creează cu succes o rambursare prin banca sa, evenimentul va fi reflectat pe gateway, iar motivul va apărea în câmpul transaction.dispute.reason. Pentru mai multe informații, consultați tranzacția de rambursare.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"browserPayment":{
"operation":"PAY",
"returnUrl":"https://<return_url>"
},
"customer": {
"email": "john.smith@example.com"
},
"order": {
"amount": "10.00",
"currency": "EUR"
},
"sourceOfFunds": {
"type": "SEPA",
"provided": {
"sepa": {
"iban": "GB33BUKB20201555555555",
"bankAccountHolder": "John Smith"
}
}
}
}
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 SEPA.
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.sepa.bankAccountHoldersourceOfFunds.provided.sepa.iban sourceOfFunds.provided.sepa.bic
|
Plata a fost realizată cu succes. |
response.gatewayCode=PENDINGresult=PENDING |
Payment 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 Payment 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ă. Payment Gateway va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
Rambursări
Plățile SEPA pot fi rambursate integral sau parțial. Trebuie să configurați rambursările pe gateway și în contul dvs. de comerciant de la furnizorul de servicii APM.
Testarea integrării
Payment Gateway furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea SEPA.