- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Klarna Pay Later
Klarna Pay Later
Klarna Pay Later este o metodă de plată furnizată de Klarna AB, o bancă suedeză apreciată, plătitorilor din Europa.
Cu Klarna Pay Later, plătitorii pot face plata în numărul specificat de zile. Plătitorii primesc articolele livrate de comerciant și le păstrează numai pe cele pe care doresc să le cumpere și să le plătească, toate articolele nedorite fiind returnate. Pentru plățile aprobate, Klarna AB își asumă integral creditul și riscul de fraudă, iar dvs. primiți de la Klarna întreaga valoare a comenzii. Asigurați-vă că rambursați fiecare articol returnat de către plătitor prin operațiunea Refund. Comenzile pot fi anulate de plătitori prin efectuarea unei rambursări a întregii valori a achiziției. Apoi, Klarna Pay Later va emite o factură către plătitor și va colecta plata, trimițând prin e-mail notificări și mementouri înainte de data scadentă a plății.
Metoda Klarna Pay Later este acceptată în QNB ALAHLI. Această pagină descrie detaliile integrării specifice metodelor de plată Klarna Pay Later. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare Klarna Pay Later.
Cerințe preliminare
Pentru a oferi metoda de plată Klarna Pay Later prin QNB ALAHLI:
- trebuie să vă înregistrați la furnizorul dvs. de servicii de plată prin browser,
- profilul dvs. de comerciant de pe QNB ALAHLI 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.
Tranzacții Klarna Pay Later
Klarna Pay Later permite tranzacțiile provenind din mai multe țări, cu monedele corespunzătoare.
| Țara | Moneda |
|---|---|
| Austria (AUT) | EUR |
| Belgia (BEL) | EUR |
| Danemarca (DNK) | DKK |
| Finlanda (FIN) | EUR |
| Germania (DEU) | EUR |
| Regatul Unit (GBR) | GBP |
| Țările de Jos (NLD) | EUR |
| Norvegia (NOR) | NOK |
| Polonia (POL) | PLN |
| Suedia (SWE) | SEK |
| Elveția (CHE) | CHF |
Integrarea Klarna Pay Later
Integrarea <<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 către QNB ALAHLI.
Începând cu versiunea API 52, Klarna Pay Later 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 <<checkout>>.
Integrarea <<directPayment>> vă permite să oferiți metoda de plată Klarna Pay Later pe propria dvs. pagină de validare.
Klarna Pay Later este acceptat începând din <<webServicesIntegration>> versiunea 52.
Efectuați o solicitare Initiate Browser Payment unde sourceOfFunds.type = KLARNA_PAY_LATER și browserPayment.operation = PAY (operațiunea Authorize nu este acceptată de către Klarna Pay Later).
sourceOfFunds.type = KLARNA PAY LATER atunci când efectuați solicitarea Initiate Browser Payment.
{
"apiOperation": "INITIATE_BROWSER_PAYMENT",
"browserPayment": {
"operation": "PAY",
"returnUrl": "<your_merchant_URL>"
},
"customer": {
"email": "john.smith@example.com",
"firstName": "John",
"lastName": "Smith",
"mobilePhone": "01234567890"
},
"billing": {
"address": {
"street": "10 Upper Bank Street",
"postcodeZip": "E14 5NP",
"city": "London",
"country": "GBR"
}
},
"order": {
"amount": 57.2,
"currency": "GBP",
"item": [
{
"name": "Blue Jeans",
"quantity": "1",
"unitPrice": 70.83,
"unitDiscountAmount": 48.16,
"unitTaxAmount": 4.53,
"detail": {
"unitTaxRate": 0.2
}
},
{
"name": "Red Shirt",
"quantity": "1",
"unitPrice": 20.83,
"unitTaxAmount": 4.17,
"detail": {
"unitTaxRate": 0.2
}
},
{
"name": "Shipping & Handling",
"quantity": "1",
"unitPrice": 4.17,
"unitTaxAmount": 0.83,
"detail": {
"unitTaxRate": 0.2
}
}
]
},
"sourceOfFunds": {
"type": "KLARNA_PAY_LATER"
}
}
În plus față de câmpurile standard obligatorii într-o solicitare de plată prin browser, trebuie să furnizați următoarele informații obligatorii pentru procesarea Klarna Pay Later.
Adresa de facturare și detaliile de contact
În absența altor indicații, aceste câmpuri sunt obligatorii și sunt necesare pentru a permite procesele Klarna Pay Later de evaluare a riscului și verificare a creditului. Informațiile de contact ale plătitorului sunt utilizate pentru comunicarea cu plătitorul și trimiterea facturilor electronice și a notificărilor de plată.
billing.address.citybilling.address.countrybilling.address.postcodeZipbilling.address.streetcustomer.emailcustomer.firstNamecustomer.lastNamecustomer.mobilePhone: Acest câmp este obligatoriu atunci când câmpulcustomer.phonenu este completat.customer.phone: Acest câmp este obligatoriu atunci când câmpulcustomer.mobilePhonenu este completat.
Adresa de livrare și detaliile de contact
Aceste câmpuri sunt obligatorii atunci când oricare dintre câmpurile shipping.address.* sau shipping.contact.* este completat.
shipping.address.cityshipping.address.countryshipping.address.postcodeZipshipping.address.streetshipping.contact.emailshipping.contact.firstNameshipping.contact.lastName
Detaliile articolelor din cadrul comenzii
Furnizați detalii complete despre fiecare dintre articolele achiziționate prin comandă, pentru a permite Klarna Pay Later să valideze și să afișeze corect aceste informații pentru plătitori și a susține procesele Klarna Pay Later de verificare a riscului și creditului.
order.item[n].nameorder.item[n].quantity: Valoarea acestui câmp trebuie să fie un număr întreg.order.item[n].unitPriceorder.item[n].unitDiscountAmount: Acest câmp este obligatoriu atunci când articolul are preț redus și trebuie completat dacă este introdusă o valoare în câmpulorder.discount.amount.order.item[n].unitTaxAmount: Acest câmp este obligatoriu atunci când plătitorul trebuie să plătească taxe pentru articol.order.item[n].detail.unitTaxRate: Acest câmp este obligatoriu atunci când a fost completată valoarea unitară a taxelor.
Expedierea și manipularea
Valoarea totală a taxelor de plată pentru comandă este afișată pentru plătitori în timpul procesului de plată. Dacă suma de plată pentru expediere și manipulare include taxe, trebuie să creați în cadrul comenzii un rând care să reprezinte expedierea și manipularea, pentru indicarea separată a valorii taxelor. Dacă nu se aplică nicio taxă, atunci valoarea expedierii și manipulării poate fi introdusă în câmpul order.shippingAndHandlingAmount.
Limba preferată
Puteți seta limba în care doriți ca serviciul Klarna Pay Later să afișeze paginile pentru plătitori, completând câmpul browserPayment.preferredLanguage din solicitarea Initiate Browser Payment. Pentru Klarna Pay Later, vor fi acceptate, însă, numai limba națională principală din billing.address.country sau limba engleză.
Rambursările
Metoda Klarna Pay Later este expusă riscului de rambursare. Dacă plătitorii dispută cu succes o plată prin Klarna Pay Later, o tranzacție de rambursare va fi creată pentru comanda respectivă. Pentru mai multe informații, consultați tranzacția de rambursare.
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 Klarna Pay Later.
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 |
QNB ALAHLI 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 QNB ALAHLI. |
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ă. QNB ALAHLI va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
ID-urile de comandă Klarna Pay Later
Pentru plățile aprobate, QNB ALAHLI vă va furniza ID-ul alocat de Klarna Pay Later comenzii în câmpul transaction.acquirer.additionalResponseData. Această informație poate fi utilă în cazul în care veți comunica direct cu Klarna Pay Later.
Notificări Webhook
Dacă v-ați abonat la notificările Webhook QNB ALAHLI, puteți primi notificări suplimentare pentru actualizările stării de finanțare și rambursări.
Testarea integrării
QNB ALAHLI furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea Klarna Pay Later.