- Ghid de integrare
- Caracteristici acceptate (Metode de plată)
- Implementarea unei integrări pentru plată prin browser
- Plățile Klarna
Klarna
Klarna AB este o cunoscută bancă suedeză, care oferă plătitorilor din Europa o varietate de opțiuni de finanțare flexibile pentru achiziția de bunuri online. Folosind metodele de plată Klarna, plătitorii au opțiunea de a plăti imediat, de a întârzia plata până la livrare sau de a distribui costurile în mai multe rate.
Metodele de plată Klarna sunt acceptate în <<paymentGateway>>. Această pagină descrie detaliile integrării specifice metodelor de plată Klarna. Este recomandat să citiți ghidul de integrare pentru plățile prin browser înainte de a crea o integrare Klarna.
Cerințe preliminare
Pentru a oferi metodele de plată Klarna 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 bancar într-una dintre monedele acceptate, asociat contului dvs. de comerciant de la furnizorul de servicii de plată prin browser.
Klarna Pay Later
Klarna AB este o bancă suedeză care oferă Klarna Pay Later – o opțiune de plată întârziată. 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 care vă este 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 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.
Klarna Pay Later permite tranzacțiile provenind din mai multe țări, cu monedele corespunzătoare.
| Țara | Monedă |
|---|---|
| Austria (AUT) | EUR |
| Germania (DEU) | EUR |
| Țările de Jos (NLD) | EUR |
| Finlanda (FIN) | EUR |
| Suedia (SWE) | SEK |
| Norvegia (NOR) | NOK |
| Regatul Unit (GBR) | GBP |
| Danemarca (DNK) | DKK |
Klarna Financing
Klarna AB este o bancă suedeză care oferă Klarna Financing – o opțiune de plată flexibilă. Este un acord de finanțare pe termen lung, prin care plătitorul poate achiziționa un articol plătindu-l în rate. Puteți alege să plătiți în șase până la treizeci și șase rate lunare egale, inclusiv dobânda (dacă există), să plătiți o sumă minimă în fiecare lună sau să plătiți întreaga sumă într-o lună.
Klarna Financing permite tranzacțiile provenind din mai multe țări, cu monedele corespunzătoare.
| Țara | Monedă |
|---|---|
| Austria (AUT) | EUR |
| Germania (DEU) | EUR |
| Țările de Jos (NLD) | EUR |
| Finlanda (FIN) | EUR |
| Suedia (SWE) | SEK |
| Norvegia (NOR) | NOK |
| Regatul Unit (GBR) | GBP |
| Danemarca (DNK) | DKK |
Klarna Pay Now
Klarna AB este o bancă suedeză care oferă Klarna Pay Now – o opțiune de plată imediată. Plătitorii pot efectua plata printr-un transfer bancar, prin debit direct sau folosind orice card.
Klarna Pay Now permite tranzacțiile provenind din mai multe țări, cu monedele corespunzătoare.
| Țara | Monedă |
|---|---|
| Austria (AUT) | EUR |
| Germania (DEU) | EUR |
| Țările de Jos (NLD) | EUR |
| Suedia (SWE) | SEK |
Integrarea Klarna
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 <<paymentGateway>>.
Klarna Pay Later
Începând cu versiunea API 52, Klarna Pay Later este automat disponibil ca metodă de plată odată ce <<paymentServiceProvider>> activează și configurează această metodă de plată pentru dvs.
Klarna Financing
Începând cu versiunea API 62, Klarna Financing este automat disponibil ca metodă de plată odată ce <<paymentServiceProvider>> activează și configurează această metodă de plată pentru dvs.
Klarna Pay Now
Klarna Pay Now va fi disponibil în curând prin <<checkout>>. Vă rugăm să contactați <<paymentServiceProvider>> pentru mai multe informații.
Pentru detalii, consultați Plățile prin browser în integrarea <<checkout>>.
Integrarea <<directPayment>> vă permite să oferiți metodele de plată Klarna pe propria dvs. pagină de validare.
Klarna Pay Later
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).
sourceOfFunds.type = KLARNA 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"
}
}
Klarna Financing
Klarna Financing este acceptat începând din <<webServicesIntegration>> versiunea 61.
Efectuați o solicitare Initiate Browser Payment unde sourceOfFunds.type = KLARNA_FINANCING și browserPayment.operation = PAY (operațiunea Authorize nu este acceptată de către Klarna).
{
"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":99.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":"Leather Belt",
"quantity":"1",
"unitPrice":25,
"unitTaxAmount":5,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Baseball Cap",
"quantity":"1",
"unitPrice":10,
"unitTaxAmount":2,
"detail":{
"unitTaxRate":0.2
}
},
{
"name":"Shipping and Handling",
"quantity":"1",
"unitPrice":4.17,
"unitTaxAmount":0.83,
"detail":{
"unitTaxRate":0.2
}
}
]
},
"sourceOfFunds":{
"type":"KLARNA_FINANCING"
}
}
Klarna Pay Now
Klarna Pay Now este acceptat începând din <<webServicesIntegration>> 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).
{
"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"
}
}
Î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.
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 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 să valideze și să afișeze corect aceste informații pentru plătitori și a susține procesele Klarna 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 să afișeze paginile pentru plătitori, completând câmpul browserPayment.preferredLanguage din solicitarea Initiate Browser Payment. Pentru Klarna, vor fi acceptate, însă, numai limba națională principală din billing.address.country sau limba engleză.
Rambursările
Plățile Klarna sunt expuse riscului de rambursare. Dacă plătitorii dispută cu succes o plată prin Klarna, 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.
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 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ă. <<paymentGateway>> va încerca să se asigure că tranzacția nu a avut succes sau o va anula. |
ID-ul de comandă Klarna
Pentru plățile aprobate, <<paymentGateway>> vă va furniza ID-ul alocat de Klarna comenzii în câmpul transaction.acquirer.additionalResponseData. Această informație poate fi utilă în cazul în care veți comunica direct cu Klarna.
Notificări Webhook
Dacă v-ați abonat la notificările Webhook <<paymentGateway>>, puteți primi notificări suplimentare pentru actualizările stării de finanțare și rambursări.
Testarea integrării
<<paymentGateway>> furnizează un emulator de plăți prin browser care vă permite să vă testați integrarea Klarna.