საინსტალაციო სახელმძღვანელო
# BOG Installment & BNPL — WordPress/WooCommerce პლაგინი
საქართველოს ბანკის განვადებისა და „ნაწილ-ნაწილი“ (Buy Now, Pay Later) სერვისების ინტეგრაცია WooCommerce-ისთვის.
---
## ფუნქციონალი
**განვადება:**
* საქართველოს ბანკის ონლაინ განვადება
* პროდუქტის გვერდიდან განვადების მოთხოვნა
* კალათის გვერდიდან განვადების მოთხოვნა
* Checkout-იდან განვადების გაფორმება
* BOG Smart Button მხარდაჭერა
**BNPL (ნაწილ-ნაწილი):**
* Buy Now, Pay Later სერვისი
* შეკვეთის ეტაპზე განაცხადის გაგზავნა
* ავტომატური გადამისამართება BOG-ის პლატფორმაზე
* WooCommerce შეკვეთასთან ინტეგრაცია
**სხვა:**
* WooCommerce Checkout მხარდაჭერა
* HTTPS მხარდაჭერა
* Test და Production გარემო
* Debug Mode
* BOG Payment Gateway-თან ინტეგრაცია
* HPOS მხარდაჭერა
---
## ინსტალაცია
1. ZIP ფაილი ატვირთეთ WordPress-ში:
```text
wp-admin → Plugins → Add New → Upload Plugin
```
2. გაააქტიურეთ პლაგინი.
3. გადადით:
```text
WooCommerce → Settings → Payments
```
4. ჩართეთ:
* BOG განვადება
* BOG ნაწილ-ნაწილი
5. შეინახეთ პარამეტრები.
---
## BOG API პარამეტრები
პლაგინის სამუშაოდ საჭიროა:
* Client ID
* Client Secret
თუ საიტზე უკვე დაყენებულია **BOG Payment Gateway**, რეკვიზიტები ავტომატურად იქნება გამოყენებული.
---
## ძირითადი პარამეტრები
### ზოგადი
* ჩართვა / გამორთვა
* გადახდის მეთოდის სახელი
* გადახდის მეთოდის აღწერა
* Client ID
* Client Secret
---
### ვიზუალური პარამეტრები
* პროდუქტის გვერდზე კალკულატორის ჩვენება
* კალათის გვერდზე კალკულატორის ჩვენება
* BOG Smart Button-ის გამოყენება
---
## პროდუქტის გვერდის კალკულატორი
კალკულატორის ჩართვის შემთხვევაში პროდუქტის გვერდზე გამოჩნდება განვადების ღილაკი.
მომხმარებელს შეუძლია:
* განვადების პირობების ნახვა
* ყოველთვიური გადასახადის დათვლა
* განაცხადის დაწყება
---
## კალათის გვერდის კალკულატორი
კალკულატორის ჩართვის შემთხვევაში კალათის გვერდზე გამოჩნდება განვადების ღილაკი.
მომხმარებელს შეუძლია:
* კალათის სრული თანხის გადანაწილება
* განვადების პირობების ნახვა
* განაცხადის დაწყება
---
## BOG Smart Button
BOG Smart Button წარმოადგენს საქართველოს ბანკის ოფიციალურ ბრენდირებულ ღილაკს.
ჩართვის შემთხვევაში:
* გამოიყენება BOG-ის ოფიციალური დიზაინი
* მომხმარებელი მარტივად ამოიცნობს გადახდის მეთოდს
გამორთვის შემთხვევაში გამოყენებული იქნება სტანდარტული WooCommerce ღილაკი.
---
## გადახდის პროცესი
სტანდარტული პროცესი:
1. მომხმარებელი ირჩევს პროდუქტს.
2. აჭერს განვადების ან ნაწილ-ნაწილის ღილაკს.
3. გადადის საქართველოს ბანკის პლატფორმაზე.
4. ავსებს განაცხადს.
5. იღებს გადაწყვეტილებას.
6. წარმატების შემთხვევაში ბრუნდება საიტზე.
7. WooCommerce შეკვეთა ავტომატურად განახლდება.
---
## შეკვეთების სტატუსები
| სტატუსი | აღწერა |
| ---------- | --------------------------------- |
| Pending | განაცხადი დაწყებულია |
| On Hold | ელოდება ბანკის პასუხს |
| Processing | განაცხადი დამტკიცებულია |
| Completed | შეკვეთა დასრულებულია |
| Failed | განაცხადი ან გადახდა ვერ შესრულდა |
| Cancelled | განაცხადი გაუქმებულია |
---
## დებაგი
პრობლემების დიაგნოსტიკისთვის შესაძლებელია Debug Mode-ის ჩართვა.
ლოგების სანახავად გამოიყენეთ:
```text
WooCommerce → Status → Logs
```
ლოგებში ჩანს:
* API მოთხოვნები
* API პასუხები
* განაცხადის სტატუსები
* სისტემური შეტყობინებები
* შეცდომები
---
## ხშირი პრობლემები
### განვადების ღილაკი არ ჩანს
შეამოწმეთ:
* პლაგინი ჩართულია თუ არა
* WooCommerce აქტიურია თუ არა
* პროდუქტის ან კალათის კალკულატორი ჩართულია თუ არა
---
### Client ID არ არის მითითებული
შეამოწმეთ:
* Client ID
* Client Secret
* BOG Payment Gateway ინტეგრაცია
---
### კალკულატორი არ იტვირთება
შეამოწმეთ:
* HTTPS
* JavaScript შეცდომები
* ბრაუზერის Console
---
### განაცხადი ვერ იგზავნება
შეამოწმეთ:
* Client ID
* Client Secret
* ინტერნეტ კავშირი
* Debug ლოგები
---
## უსაფრთხოების რეკომენდაციები
* Client Secret არ გააზიაროთ მესამე პირებთან.
* გამოიყენეთ მხოლოდ HTTPS.
* Debug Mode ჩართეთ მხოლოდ ტესტირების დროს.
* ადმინისტრატორის წვდომა მიანიჭეთ მხოლოდ სანდო მომხმარებლებს.
---
## მხარდაჭერა
საქართველოს ბანკის სერვისებთან დაკავშირებული საკითხებისთვის დაუკავშირდით ბანკის მხარდაჭერის გუნდს.
პლაგინის ტექნიკური საკითხებისთვის დაუკავშირდით პლაგინის დეველოპერს.
---
## შენიშვნა
* პლაგინის გამოყენებისთვის საჭიროა საქართველოს ბანკის აქტიური განვადების ან BNPL სერვისი.
* ზოგიერთი პროდუქტი ან კატეგორია შესაძლოა არ ექვემდებარებოდეს განვადებას ბანკის წესების მიხედვით.
* HTTPS სავალდებულოა.
* Production რეჟიმში გამოყენებამდე რეკომენდებულია ტესტირება.
* WooCommerce შეკვეთების სტატუსები ავტომატურად ახლდება ბანკის პასუხის მიხედვით.
---
*BOG Installment & BNPL — ვერსია 1.0.0*