Kako konfigurisati postavke plaćanja

Ovaj sveobuhvatni vodič će vas provesti kroz postupak postavljanja opcija plaćanja za vašu online prodavnicu. Naučićete kako integrirati različite payment gateway-e i omogućiti sigurne transakcije za vaše kupce.

Šta ćete naučiti

  • 💳 Pristupanje opcijama plaćanja
  • 🏦 Konfiguracija Monri payment gateway-a
  • 🏧 Postavljanje NLB Bankart sistema
  • 💰 Integracija PayPal-a i drugih opcija
  • 🔐 Sigurnosne postavke i API ključevi
  • ✅ Testiranje i verifikacija
  • 📊 Praćenje transakcija
  • 🛡️ PCI DSS compliance

Prije početka

Šta trebate pripremiti:

  • ✅ Ugovor sa bankom/payment providerom
  • ✅ Merchant račun aktivan
  • ✅ API kredencijale od providera
  • ✅ SSL certifikat instaliran
  • ✅ Verifikovani poslovni podaci

1. Pristupanje opcijama plaćanja

Navigacija do payment postavki

U administratorskom panelu:

  1. Pronađite glavni meni sa opcijama
  2. Kliknite na 💳 "Plaćanja" (označeno ljubičastim krugom)

Dostupne opcije u meniju:

  • Opcije plaćanja ← Vi ste ovdje
    • Glavni meni za sve payment opcije
  • Postavke plaćanja
    • Detaljna konfiguracija
  • Transakcije
    • Pregled svih transakcija
  • 🛟 Podrška
    • Pomoć i dokumentacija
  • 🚪 Odjava
    • Sigurno napuštanje sistema

💡 Savjet: Možete sakriti meni klikom na "Sakrij meni" za više radnog prostora.

Zašto su payment opcije kritične:

  • 🛒 Direktan uticaj na konverziju
  • 🔒 Sigurnost transakcija
  • 🌍 Lokalne i međunarodne opcije
  • 📱 Mobile payment podrška

2. Pregled opcija plaćanja

Glavni ekran opcija plaćanja

Nakon klika na "Plaćanja", vidite:

Dostupne kategorije:

  1. Online plaćanja

    • Kartice (Visa, MasterCard, Maestro)
    • E-walleti (PayPal, Skrill)
    • Instant bankarstvo
  2. Offline plaćanja

    • Pouzećem (Cash on Delivery)
    • Virman/Uplatnica
    • Lično preuzimanje
  3. Alternativne metode

    • Kripto valute
    • Rate/Krediti
    • Vaučeri i pokloni

Status indikatora:

  • 🟢 Aktivno - Gateway funkcioniše
  • 🟡 Konfiguracija - Potrebno dovršiti
  • 🔴 Neaktivno - Isključeno ili greška

3. Plaćanja

Pristupanje detaljnim postavkama

Kliknite na "Plaćanja" da otvorite opcije konfiguracije.

Sekcije koje će se otvoriti:

  1. Payment Gateway-i
    • Lista dostupnih providera
    • Status svake integracije

4. Izbor payment providera - Monri

Konfiguracija Monri gateway-a

Kliknite na "Monri" (označeno ljubičastim krugom) - MEMBER OF Payten.

O Monri payment gateway-u:

  • Region: BiH, Hrvatska, Srbija
  • Kartice: Visa, MasterCard, Maestro, Diners
  • 3D Secure: Potpuna podrška
  • Valute: BAM, EUR, HRK, RSD
  • Processing: Real-time autorizacija

Alternativni provider - NLB

Na desnoj strani vidite NLB opciju sa ljubičastim krugom.

O NLB Bankart sistemu:

  • Region: Slovenija, BiH
  • Podrška: 24/7 tehnička pomoć
  • Integracija: REST API
  • Sigurnost: PCI DSS Level 1

Dodatni provideri (mogu biti dostupni):

  • PayPal - Globalni e-wallet
  • Stripe - Međunarodni gateway
  • CorvusPay - Regionalni provider

5. Monri konfiguracija - Authenticity Token

Forma za Monri postavke

Kada otvorite Monri konfiguraciju, vidite:

Vizuelni prikaz payment opcija:

  • Monri logo (MEMBER OF Payten)
  • NLB Banka logo
  • PayPal logo
  • Stripe opcija

✅ Checkbox "Monri Konfiguracija"

  • Označen checkbox aktivira Monri
  • Ukoliko je podešeno, korisnici vide ovu opciju na checkout-u

📝 Polje "AUTHENTICITY TOKEN*"

  • Označeno: Ljubičastim krugom
  • Obavezno: Zvjezdica (*) označava
  • Format: Alfanumerički string
  • Dužina: Obično 32-64 karaktera
  • Gdje pronaći: Monri merchant portal
Primjer formata:
a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Upute ispod polja:

"Get Monri Authenticity Token"

  • Link vodi na Monri dokumentaciju
  • Ili kontaktirajte Monri podršku

📝 Polje "MERCHANT KEY*"

  • Drugo obavezno polje
  • Jedinstveni identifikator trgovca
  • Format: TEST ili PRODUCTION key
Primjer formata:
TEST: TestMerchant12345
PROD: LiveMerchant67890

Dugme "Sačuvaj konfiguraciju"

  • Plavo dugme na dnu
  • Validira i čuva postavke
  • Testira konekciju sa Monri

6. Unos Merchant Key-a

Polje "MERCHANT KEY*"

Kliknite u polje "MERCHANT KEY"* da unesete merchant ključ.

🔑 O Merchant Key-u:

  • Svrha: Identifikacija vašeg merchant računa
  • Jedinstveni: Svaki trgovac ima svoj
  • Sigurnost: Nikad ne dijelite javno
  • Environment: Različit za TEST i LIVE

Tipovi merchant key-a:

TEST Environment:
Prefix: TEST_
Primjer: TEST_SHOP_12345
Svrha: Razvoj i testiranje
Transakcije: Nisu stvarne
PRODUCTION Environment:
Prefix: PROD_ ili bez
Primjer: SHOP_67890
Svrha: Stvarne transakcije
Transakcije: Prave, naplaćuju se

⚠️ Sigurnosne napomene:

  • Čuvajte key u sigurnom password manageru
  • Rotirajte key-eve periodično
  • Koristite environment varijable
  • Ne komitujte u Git

7. NLB Bankart konfiguracija

Prebacivanje na NLB

Kliknite na "NLB" da konfigurirate NLB Bankart postavke.

O NLB Bankart sistemu:

  • Banka: Nova Ljubljanska Banka
  • Coverage: Slovenija, BiH, region
  • API: RESTful web servisi
  • Dokumentacija: Detaljna tehnička

Prednosti NLB Bankart:

  • ✅ Lokalna podrška na vašem jeziku
  • ✅ Konkurentne provizije
  • ✅ Brza settlements (1-2 dana)
  • ✅ Multi-valuta transakcije
  • ✅ Recurring payments podrška

Integracija zahtjeva:

  1. Aktivan poslovni račun u NLB
  2. Potpisan ugovor za e-commerce
  3. Verifikovan SSL certifikat
  4. PCI DSS compliance

8. NLB - API Key unos

Polje "API KEY*"

Kliknite u polje "API KEY"* da unesete ključ za NLB-Bankart sistem.

🔐 Format API Key-a:

Dužina: 40-50 karaktera
Format: Alphanumeric + specijalni
Primjer: nlb_live_pk_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8

Tipovi API ključeva:

Sandbox/Test:
Prefix: nlb_test_
Koristi: Development
Limit: 100 transakcija/dan
Production/Live:
Prefix: nlb_live_
Koristi: Stvarne transakcije
Limit: Neograničeno

📋 Gdje pronaći API Key:

  1. Logirajte se na NLB Merchant Portal
  2. Idite na Settings → API Credentials
  3. Generirajte novi key ako nemate
  4. Kopirajte sa oprezom

9. Ponovni unos API Key-a

Verifikacija API Key-a

Sistem može tražiti ponovni unos radi sigurnosti.

✅ Double-check lista:

  • Key je kompletan (svi karakteri)
  • Nema razmaka na početku/kraju
  • Odgovara environment-u (test/live)
  • Caps Lock je isključen
  • Copy-paste bez formatiranja

🔄 Validacija u realnom vremenu:

  • Sistem provjerava format
  • Testira konekciju sa NLB
  • Prikazuje status validacije
  • Greške se prikazuju odmah

10. API Username

Polje "API USERNAME*"

Kliknite u polje "API USERNAME"* da unesete korisničko ime za API pristup.

👤 O API Username:

  • Format: Email ili custom username
  • Primjer: merchant@vasafirma.ba
  • Alternativa: SHOP_12345_API
  • Case sensitive: Da

Kreiranje API Username:

  1. U NLB portalu:

    • Settings → API Users
    • Create New User
    • Assign permissions
    • Generate credentials
  2. Permisije potrebne:

    • Transaction processing
    • Refund capability
    • Report access
    • Webhook management

🔐 Najbolje prakse:

  • Koristite service account, ne personal
  • Omogućite 2FA gdje je moguće
  • Rotirajte kredencijale kvartalno
  • Logujte sve API pozive

11. API Password

Polje "API PASSWORD*"

Kliknite u polje "API PASSWORD"* da unesete lozinku za API pristup.

🔒 Sigurnosni zahtjevi za password:

  • Minimalno: 12 karaktera
  • Mora sadržati:
    • Velika slova (A-Z)
    • Mala slova (a-z)
    • Brojeve (0-9)
    • Specijalne znakove (!@#$%^&*)
  • Ne smije: Biti isti kao username

Primjer jakog password-a:

P@ssw0rd!2024#NLB

⚠️ KRITIČNO - Sigurnost:

  1. NIKAD ne čuvajte u:

    • Plain text fajlovima
    • Email-ovima
    • Chat porukama
    • Git repozitorijumu
  2. UVIJEK koristite:

    • Password manager
    • Environment varijable
    • Encrypted storage
    • Secret management sistem

12. Integration Key

Polje "INTEGRATION KEY*"

Kliknite u polje "INTEGRATION KEY"* da unesete ključ za NLB-Bankart integraciju.

🔑 O Integration Key:

  • Svrha: Webhook i callback autentifikacija
  • Format: UUID ili custom string
  • Dužina: Obično 36 karaktera
  • Regeneracija: Moguća u portalu

Format primjer:

550e8400-e29b-41d4-a716-446655440000

Funkcionalnost Integration Key-a:

  1. Webhook Security:

    • Potpisuje callback poruke
    • Validira dolazne notifikacije
    • Sprječava MITM napade
  2. Transaction Verification:

    • Potvrđuje autentičnost
    • Hash za svaku transakciju
    • Audit trail

✅ Finalna provjera prije čuvanja:

  • Svi * (obavezni) fieldovi popunjeni
  • API key valjan
  • Username/password par testiran
  • Integration key aktivan
  • SSL certifikat instaliran

💾 Čuvanje konfiguracije:

  1. Kliknite "Sačuvaj konfiguraciju"
  2. Sistem validira sve podatke
  3. Testira konekciju sa providerom
  4. Prikazuje status poruku

13. Testiranje payment gateway-a

🧪 Test transakcije

Nakon konfiguracije, OBAVEZNO testirajte:

Test kartica za Monri:

Visa Test: 4111 1111 1111 1111
MasterCard Test: 5500 0000 0000 0004
CVV: 123
Datum: Bilo koji budući

Test proces:

  1. Prebacite na TEST mode
  2. Kreirajte test narudžbu
  3. Prođite checkout proces
  4. Verifikujte u merchant portalu
  5. Testirajte refund

Što testirati:

  • ✅ Uspješna transakcija
  • ✅ Odbijena kartica
  • ✅ 3D Secure flow
  • ✅ Partial refund
  • ✅ Full refund
  • ✅ Recurring payment
  • ❌ Network timeout
  • ❌ Invalid credentials

14. Dodatne opcije plaćanja

💰 Plaćanje pouzećem (COD)

Aktivacija:

  1. Plaćanje pouzećem je automatski uključeno

💳 PayPal integracija

Proces:

  1. Kreirajte PayPal Business
  2. Omogućite API pristup
  3. Kopirajte Client ID
  4. Unesite Secret Key

Prednosti:

  • Globalni doseg
  • Buyer protection
  • Instant checkout
  • Mobile optimized

16. Česti problemi i rješenja

🔴 Problem: "Invalid API Key"

Rješenja:

  1. Provjerite da li je key za pravi environment
  2. Uklonite whitespace karaktere
  3. Regenerirajte key u portalu
  4. Kontaktirajte provider podršku

🔴 Problem: "Transaction Failed"

Rješenja:

  1. Provjerite merchant account status
  2. Verifikujte SSL certifikat
  3. Testirajte sa test karticama
  4. Provjerite error logove

🔴 Problem: "3D Secure not working"

Rješenja:

  1. Aktivirajte u merchant portalu
  2. Update na 3DS 2.0
  3. Provjerite callback URL
  4. Testirajte sa različitim bankama

🔴 Problem: "Settlements kasne"

Rješenja:

  1. Provjerite cut-off vrijeme
  2. Verifikujte bankovni račun
  3. Kontaktirajte acquiring banku
  4. Provjerite za chargeback-ove

📞 Podrška:

⚠️ Važno: Redovno ažurirajte API ključeve i pratite security best practices!


Trebate dodatnu pomoć?

Ako imate pitanja ili probleme, kontaktirajte našu podršku:

📧 Email podrška