=== XPay za WooCommerce ===
Contributors: nolimitdevelopments
Tags: payments, qr, bank transfer, bosnia, serbia, woocommerce
Requires at least: 6.0
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 0.76.168
License: MIT

Plaćanje bankovnim prenosom uz QR kod (XPay), direktno na račun prodavnice.

== Opis ==

Kupac na kasi izabere „Plaćanje bankovnim prenosom uz QR (XPay)" i dobije
stranicu sa QR kodom, brojem računa i pozivom na broj. Plati iz aplikacije
svoje banke (ili prepiše podatke u nalog za prenos) i vrati se u prodavnicu.
Kad uplata legne, XPay javi prodavnici i narudžba se sama označi plaćenom.
Novac ide direktno na račun prodavnice; XPay ga ne dodiruje.

Dok narudžba čeka uplatu, isti kod i podaci za uplatu stoje i na stranici
narudžbe i u e-mailu kupcu, pa kupac koji je zatvorio stranicu ili naručio sa
računara plati kasnije s telefona.

Radi za prodavnice u KM (BiH) i u dinarima (Srbija): iz valute prodavnice XPay
bira kod koji banke tamo skeniraju. Sve što kupac čita je na bosanskom,
srpskom ili engleskom, po izboru u podešavanju.

== Instalacija ==

1. Dodaci, Dodaj novi, Prenesi dodatak: `xpay-woocommerce.zip`, pa uključite dodatak.
2. U XPay konzoli, pod **Za programere**, napravite API ključ s opsegom
   `payments:write`. Prikazuje se jednom.
3. Isto tamo dodajte webhook na adresu `https://vasa-prodavnica/?wc-api=xpay`
   za događaje `payment.*` i sačuvajte tajnu koju konzola pokaže.
4. U WooCommerce, Postavke, Plaćanja, XPay: izaberite jezik kupca, upišite
   adresu API-ja, ključ i tajnu webhooka, uključite i sačuvajte.
5. Napravite probnu narudžbu od 1 KM (ili 100 RSD) i platite je s telefona.

== Podešavanja ==

* Jezik kupca: bosanski, srpski ili engleski. Naziv na kasi, stranica narudžbe
  i e-mail kupcu idu na tom jeziku; naziv i opis na kasi možete i sami upisati.
* Adresa XPay API-ja: `https://api.xpay.ba`, ili probni server.
* API ključ i tajna webhooka: iz XPay konzole, Za programere.

== Šta se dešava s narudžbom ==

* uplata stigla u cijelosti: narudžba je plaćena (processing), bilješka nosi iznos i poziv na broj
* stiglo više: plaćena, uz bilješku da se razlika vraća iz banke
* stiglo manje: na čekanju (on-hold), uz bilješku koliko fali
* kod istekao ili otkazano: bilješka; kupac može ponovo izabrati XPay
* stranica narudžbe i sama provjeri stanje kad se kupac vrati, pa spor webhook ne ostavlja plaćenu narudžbu kao neplaćenu
* dok narudžba nije plaćena, stranica narudžbe i e-mail kupcu nose kod, račun, poziv na broj i link na stranicu za plaćanje

== Povrati ==

Dodatak ne radi povrate. Povrat se šalje iz banke prodavnice, a u XPay konzoli se
evidentira pod Plaćanja.

== Provjera bez WordPressa ==

`php test/harness.php` iz foldera `integrations/woocommerce` provjerava potpis
webhooka, obradu ishoda, valute, jezike i podatke za uplatu bez WordPress
instalacije. Nije zamjena za probu na živoj prodavnici.
