- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Klarna Pay Now
Klarna Pay Now
Klarna Pay Now este o metodă de plată furnizată de Klarna AB, o bancă suedeză apreciată, plătitorilor din Europa. Plătitorii pot efectua plata printr-un transfer bancar, prin debit direct sau folosind orice card.
Metoda Klarna Pay Now este acceptată în Mastercard Gateway. Această pagină descrie detaliile integrării specifice metodei Klarna Pay Now. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare Klarna Pay Now.
Cerințe preliminare
Pentru a oferi metoda de plată Klarna Pay Now prin Mastercard Gateway:
- trebuie să vă înregistrați la furnizorul dvs. de servicii de plată prin browser
- profilul dvs. de comerciant de pe Mastercard 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.
Tranzacțiile Klarna Pay Now
Klarna Pay Now permite tranzacțiile provenind din mai multe țări, cu monedele corespunzătoare.
| Țara | Moneda |
|---|---|
| Austria (AUT) | EUR |
| Belgia (BEL) | EUR |
| Germania (DEU) | EUR |
| Italia (ITA) | EUR |
| Țările de Jos (NLD) | EUR |
| Suedia (SWE) | SEK |
| Spania (ESP) | EUR |
| Elveția (CHE) | CHF |
Integrarea Klarna Pay Now
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, Klarna Pay Now 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ă Klarna Pay Now pe propria dvs. pagină de validare.
Klarna Pay Now este acceptat începând din API versiunea 63.
Efectuați o solicitare Initiate Browser Payment unde sourceOfFunds.type = KLARNA_PAY_NOW și browserPayment.operation = PAY (operațiunea Authorize nu este acceptată de către Klarna Pay Now).
Începând din versiunea 65 a API, utilizați câmpul bankAccountCountryCode. Acest câmp specifică țara în care se află conturile bancare ale plătitorilor.
{
"apiOperation":"INITIATE_BROWSER_PAYMENT",
"billing":{
"address":{
"city":"Edinburgh",
"company":"MPGS",
"country":"DEU",
"postcodeZip":"EH123AB",
"stateProvince":"Scotland",
"street":"OceanPoint",
"street2":"OceanDrive"
}
},
"browserPayment":{
"operation":"PAY",
"returnUrl":"<your_merchant_URL>"
},
"customer":{
"account":{
"id":"custoAccount"
},
"dateOfBirth":"1999-12-31",
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith",
"mobilePhone":"01234567890",
"nationalId":"X4RTBPFW4"
},
"order":{
"amount":"154.16",
"currency":"EUR",
"item":[
{
"name":"Diesel Jeans",
"quantity":"1",
"unitPrice":"70.83"
},
{
"name":"Adidas Trainers",
"quantity":"1",
"unitPrice":"83.33"
}
]
},
"shipping":{
"address":{
"city":"Shipsville",
"country":"GBR",
"postcodeZip":"EH67DX",
"stateProvince":"Scotland",
"street":"2ShippingHeights",
"street2":"ShipsDrive"
},
"contact":{
"email":"john.smith@example.com",
"firstName":"John",
"lastName":"Smith"
}
},
"sourceOfFunds":{
"type":"KLARNA_PAY_NOW",
"provided":{
"klarnaPayNow":{
"bankAccountCountryCode":"GBR"
}
}
}
}
Î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 plăților Klarna Pay Now.
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 Now 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.customer.nationalId: Acest câmp este opțional.
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 Now să valideze și să afișeze corect aceste informații pentru plătitori și a susține procesele Klarna Pay Now 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.
Codul de țară al contului bancar al plătitorului
Trebuie să introduceți codul de țară al contului plătitorului în câmpul sourceOfFunds.provided.klarnaPayNow.bankAccountCountryCode.
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 Now să afișeze paginile pentru plătitori, completând câmpul browserPayment.preferredLanguage din solicitarea Initiate Browser Payment. Pentru Klarna Pay Now, vor fi acceptate, însă, numai limba națională principală din billing.address.country sau limba engleză.
Rambursările
Plățile Klarna Pay Now sunt expuse riscului de rambursare. Dacă plătitorii dispută cu succes o plată prin Klarna Pay Now, 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 Now.
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 |
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. |
ID-urile de comandă Klarna Pay Now
Pentru plățile aprobate, Mastercard Gateway vă va furniza ID-ul alocat de Klarna Pay Now comenzii în câmpul transaction.acquirer.additionalResponseData. Această informație poate fi utilă în cazul în care veți comunica direct cu Klarna Pay Now.
Notificări Webhook
Dacă v-ați abonat la notificările Webhook Mastercard Gateway, puteți primi notificări suplimentare pentru actualizările stării de finanțare și rambursări.
Testarea integrării
Mastercard Gateway furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea Klarna Pay Now.