Što radi ovaj dodatak?
i3 Cpay Payment Gateway for WooCommerce je WooCommerce dodatak koji dodaje Cpay (platni gateway makedonskog pružatelja CaSys) kao način plaćanja pri naplati. Kupac plaća na hostiranoj Cpay stranici; dodatak upravlja preusmjeravanjem, potpisuje zahtjev SHA-256 enkripcijom i validira odgovor prije nego što narudžba bude označena kao plaćena.
Glavne mogućnosti:
- Cpay kao način plaćanja — prikazuje se pri naplati uz ostale WooCommerce gatewaye
- SHA-256 HMAC enkripcija — svaki zahtjev i povratak potpisani su i provjeravaju se tajnim ključem
- Automatsko preusmjeravanje — nakon narudžbe kupac ide na Cpay bez dodatnih klikova (može se isključiti)
- Jezik platne stranice — makedonski, engleski, bugarski ili albanski na Cpay obrascu
- Konverzija valute — ako trgovina koristi drugu valutu (npr. EUR), tečaj pretvara iznos u MKD za Cpay (zaokruženo naviše)
- Klasična i Blocks naplata — radi sa standardnom WooCommerce naplatom i Checkout Blockom
- Obrada neuspješnog plaćanja — pri neuspjehu ili otkazivanju kupac se vraća na naplatu s porukom o grešci
Dodatak ne podržava automatske povrate putem gatewaya; povrati se moraju obraditi ručno putem Cpay ili banke.
Kako administrirati dodatak
1. Pronađite stranicu s postavkama
Nakon aktiviranja dodatka, idite na administratorsku ploču WordPressa i otvorite:
WooCommerce → Postavke → Plaćanja → Cpay Payment Gateway
(Kliknite Upravljaj pored naziva gatewaya.)
2. Uključite gateway
Označite Enable Cpay Payment Gateway (Omogući Cpay način plaćanja). Ako ovo nije označeno, Cpay se neće prikazivati pri naplati.
3. Konfigurirajte gateway
| Postavka | Što radi |
|---|---|
| Title (Naslov) | Naziv koji kupac vidi pri naplati. Zadano: Cpay Payment. |
| Description (Opis) | Kratki tekst ispod načina plaćanja. Zadano: Pay securely via Cpay. |
| Merchant Name (Ime trgovca) | Ime trgovca kako ga daje Cpay/CaSys. |
| Merchant Code (Kod trgovca) | Kod trgovca kako ga daje Cpay/CaSys. |
| Secret Key (SHA-256) (Tajni ključ) | SHA-256 tajni ključ od Cpaya za potpisivanje i provjeru. Za testiranje koristite TEST_PASS. |
| Payment Page Language (Jezik platne stranice) | Jezik Cpay obrasca: makedonski (mk-MK), engleski (en-US), bugarski (bg-BG) ili albanski (sq-AL). Zadano: makedonski. |
| Exchange Rate (MKD) (Tečaj) | Množitelj za pretvorbu iznosa u MKD kada valuta trgovine nije MKD. Koristite 1 ako su cijene već u MKD. Primjer: 61.5 ako je trgovina u EUR. |
| Auto Redirect to Cpay (Automatsko preusmjeravanje) | Kad je uključeno, kupac automatski ide na Cpay nakon naplate. Kad je isključeno, na stranici potvrde prikazuje se gumb Pay Now. Zadano: uključeno. |
| Simple mode form for Cpay (Jednostavni način) | Kad je uključeno, koristi se pojednostavljeni Cpay obrazac (isSimple). Zadano: uključeno. |
4. Nabavite Cpay pristupne podatke
Kontaktirajte Cpay/CaSys podršku ili bankovni procesor za Merchant Name, Merchant Code i Secret Key (SHA-256). TEST_PASS koristite samo za testne transakcije.
5. Spremite promjene
Kliknite Spremi promjene pri dnu stranice. Gateway je dostupan odmah nakon uključivanja i spremanja vjerodajnica.
6. Isključivanje gatewaya
Poništite odabir Enable Cpay Payment Gateway i spremite — Cpay se neće prikazivati pri naplati, nema potrebe od deinstalacije dodatka.
Kako se ponaša za kupce
- Kupac odabire Cpay Payment pri naplati i dovršava narudžbu.
- WooCommerce kreira narudžbu i preusmjerava kupca na korak Cpay plaćanja.
- Dodatak gradi potpisani platni obrazac (iznos, podaci za naplatu, return URL-ovi) i automatski ga šalje na vpos.cpay.com.mk.
- Kupac unosi podatke kartice na hostiranoj Cpay stranici na jeziku koji ste postavili.
- Pri uspješnom plaćanju Cpay vraća kupca na vašu stranicu; dodatak provjerava SHA-256 checksums i označava narudžbu kao plaćenu. Kupac ide na stranicu potvrde.
- Pri neuspješnom ili otkazanom plaćanju kupac se vraća na naplatu s porukom o grešci i može pokušati ponovno.
- Ako je Auto Redirect isključen, kupac vidi gumb Pay Now na stranici potvrde i mora kliknuti da bi otišao na Cpay.
Bilješke
- Potreban je WooCommerce — dodatak se ne aktivira bez WooCommercea.
- HPOS kompatibilan — radi s WooCommerce High-Performance Order Storage (custom order tables).
- Iznos poslan Cpayu uvijek je u MKD; koristite tečaj ako trgovina prikazuje drugu valutu.
- Sigurnost — podaci od Cpaya validiraju se s četiri checksum provjere prije promjene statusa narudžbe.
- Bez automatskih povrata — povrati se obrađuju ručno putem Cpay ili procesora.
- Spreman za prijevod — dodatak dolazi s izvornim tekstom na engleskom i prijevodima na makedonski, bugarski i albanski putem mape languages.
- Ovaj dodatak je stvoren uz pomoć umjetne inteligencije (AI). Besplatan je za korištenje, mijenjanje i distribuciju bez potrebe za dopuštenjem autora. Koristite ga na vlastitu odgovornost – uvijek napravite sigurnosnu kopiju prije testiranja ili aktiviranja na aktivnoj web stranici.