Open-source Odoo 19 modul za plaćanje: Raiffeisen RaiAccept
Kao deo tehničkih priprema AdriaMart-a, razvili smo Odoo 19 modul koji povezuje Odoo e-commerce platformu sa Raiffeisen Bank RaiAccept gateway-om. Modul je dostupan na zvaničnoj Odoo Apps prodavnici i objavljen je kao open source pod LGPL-3 licencom — koristan je svakoj firmi u Srbiji i regionu koja koristi Odoo i RaiAccept terminal.
- Odoo Apps: apps.odoo.com/apps/modules/19.0/payment_raiffeisen
- GitHub: github.com/AdriaMartHQ/payment_raiffeisen
Funkcionalnosti
- Kompletna integracija sa RaiAccept API-jem (kreiranje narudžbine, redirekcija ka checkout stranici, provera statusa)
- Podrška za naplatu u RSD ili EUR
- Ugrađena konverzija valuta sa konfigurisanim kursom
- Potpune i delimične refundacije iz Odoo backend-a
- Odvojeni produkcioni i sandbox kredencijali
- Transliteracija ćirilice u latinicu za adrese
- Webhook obrada sa autoritativnom proverom iznosa i valute na strani gateway-a
- Mapiranje kodova zemalja za 50+ država
Podržane kartice i tržišta
Kartice: Visa, Mastercard, DinaCard (nacionalna srpska shema, kreirana kao zasebna marka u Odoo-u jer je Odoo core ne obuhvata)
Apple Pay i Google Pay — planirani u narednoj verziji.
Modul podržava trgovce sa Raiffeisen business računom na sledećim tržištima:
| Zemlja | Banka | Valuta naplate |
|---|---|---|
| Srbija | Raiffeisen banka a.d. Beograd | RSD |
| Austrija | Raiffeisen Bank International | EUR |
| Hrvatska | Raiffeisenbank Austria d.d. Zagreb | EUR |
| BiH | Raiffeisen Bank d.d. BiH | EUR |
| Kosovo | Raiffeisen Bank Kosovo | EUR |
| Albanija | Raiffeisen Bank Albania | EUR |
| Rumunija | Raiffeisen Bank Romania | EUR |
| Mađarska | Raiffeisen Bank Zrt. | EUR |
| Češka | Raiffeisenbank a.s. | EUR |
| Slovačka | Tatra banka (RBI grupa) | EUR |
| Ukrajina | Raiffeisen Bank Ukraine | EUR |
Kupci iz bilo koje zemlje mogu platiti — mapiranje adresa pokriva 50+ zemalja.
Tehnički detalji
- AWS Cognito
USER_PASSWORD_AUTHautentifikacija sa RaiAccept API-jem - Redirect flow preko
_get_specific_rendering_values - Autoritativna verifikacija iznosa i valute na osnovu gateway odgovora
- Preferencija
PURCHASEtransakcija pri odabiru transaction ID-a - Refund callback rutiran po
transactionIdza ispravnu rezoluciju child transakcija - Obrada
RSDkao valute bez decimala (minor unit factor = 1 za RSD, 100 za EUR) - Strip sufiksa u
billingAddress.statekodu da odgovara RaiAccept ograničenju od 0-3 karaktera
Zahtevi
- Odoo 19.0 (Community ili Enterprise)
- Raiffeisen RaiAccept trgovački nalog
- RaiAccept API kredencijali (username + password)
Instalacija
Najbrži način — preko Odoo Apps prodavnice:
- Otvorite apps.odoo.com/apps/modules/19.0/payment_raiffeisen i preuzmite modul
- Raspakujte u svoju Odoo addons putanju
- U Odoo: Podešavanja → Aplikacije → Ažuriraj listu aplikacija
- Instalirajte Payment Provider: Raiffeisen RaiAccept
- Otvorite Fakturisanje → Konfiguracija → Provajderi plaćanja, postavite kredencijale i valutu, aktivirajte provajdera
Alternativno, klonirajte direktno sa GitHub-a ako želite da pratite najnoviju granu.
Uputstvo za RaiAccept akreditaciju i test kartice: docs.raiaccept.com
Zašto open source
Naš tim radi na pripremi Odoo e-commerce platforme za tržište Srbije, a RaiAccept integracija je deo tog koraka. Pošto je Odoo open source, smatrali smo prirodnim da i naš modul bude dostupan zajednici. Svako ko koristi istu kombinaciju (Odoo + RaiAccept) može da ga instalira, testira i doprinese poboljšanjima.
Pull request-ovi i issue-i dobrodošli.
O AdriaMart-u
AdriaMart je e-commerce projekat registrovan u Srbiji, trenutno u pripremnoj fazi pre početka rada. Ovaj modul je jedan od rezultata tehničkih priprema. Kontakt za predloge i pitanja: [email protected] ili GitHub Issues.
Licenca: LGPL-3 — slobodno za korišćenje, modifikaciju i distribuciju.