:::info

განვადების მოდალის ინტეგრაცია გჭირდებათ მხოლოდ იმ შემთხვევაში, თუ გსურთ მომხმარებელმა განვადების პირობები თქვენს გვერდზე აირჩიოს.

:::




## ნაწილ-ნაწილის ვიზუალური სახელმძღვანელო

თუ გსურთ თქვენს გვერდზე განათავსოთ ნაწილ-ნაწილის გადახდის ღილაკი, ისარგებლეთ ნაწილ-ნაწილის ვიზუალური სახელმძღვანელოთი.
გადმოსაწერად დააჭირეთ [ { e.preventDefault(); const link = document.createElement('a'); link.href = '/docs/bnpl-button-guideline.pdf'; link.download = 'bnpl-button-guideline.pdf'; document.body.appendChild(link); link.click(); document.body.removeChild(link); }}>აქ](https://api.bog.ge/docs/docs/bnpl-button-guideline.pdf).







## ონლაინ განვადების მოდალი

ონლაინ განვადების პირობების ასარჩევად, სპეციალური მოდალი დავამზადეთ. მოდალი არის ერთგვარი სესხის კალკულატორი, სადაც მომხმარებელს საშუალება აქვს, კალათის ღირებულებიდან გამომდინარე, საორიენტაციო ყოველთვიური გადასახადი და წლიური საპროცენტო განაკვეთი ნახოს.

იქიდან გამომდინარე, რომ პირობები ყოველთვის ინდივიდუალურია და საქართველოს ბანკსა და მერჩანტს შორის დადებულ ხელშეკრულებას ეყრდნობა, ასევე სააქციო პირობები (მათ შორის 0%-იანი განვადების პირობა) განსხვავდება სტანდარტული პირობებისგან, ამ ინფორმაციის მსესხებლისთვის მიწოდება მნიშვნელოვანია. ყველა ეს ინფორმაცია მოდალზე არის დატანილი, რაც მომხმარებელს უფრო მეტად ეხმარება გადაწყვეტილების მიღებაში.

შესაბამისად, განვადების აქტივაციამდე საჭიროა ერთგვარი სესხის კალკულატორი, რომელიც დამოუკიდებელი მიკროსერვისია და მერჩანტის საიტზე [ინტეგრაცია სჭირდება](https://api.bog.ge/docs/docs/payments/authentication). "საქართველოს ბანკი" გთავაზობს კალკულატორის მზა SDK-ს, რომელიც თავსებადია ყველა მოწყობილობაზე (Desktop, Mobile, Tablet) და საჭიროებს მზა კოდის ფრაგმენტის დამატებას საიტზე.







![Online Installment Modal](../../assets/installment-modal.png)

### მაგალითი:






### ინტეგრაცია

განვადების მოდალის SDK ინტეგრაციის დასაწყებათ, დააკოპირეთ კოდი HTML გვერდში. `{client_id}`-ის მაგივრად ჩასვით თქვენი client_id.

```html
<script src="https://webstatic.bog.ge/bog-sdk/bog-sdk.js?version=2&client_id={client_id}"></script>
```

---




### მოდალის ჩვენება

ონლაინ განვადების მოდალის საჩვენებლად, გამოიყენეთ `BOG.Calculator.open` მეთოდი.

#### პარამეტრები


- `amount` — number, required

  განვადების თანხა


- `bnpl` — boolean


  პარამეტრით განისაზღვრება მომხმარებელს გამოუჩნდეს `სტანდარტული განვადება` ან/და `ნაწილ-ნაწილ გადახდა`.
  - `true` - მომხმარებელს გამოუჩნდება მხოლოდ ნაწილ-ნაწილ გადახდა
  - `false` - მომხმარებელს გამოუჩნდება მხოლოდ სტანდარტული განვადება
  - `undefined` | `null` - მომხამრებელს გამოუჩნდება ორივე მეთოდი.



- `onClose` — function

  მეთოდი, რომელიც გამოიძახება SDK-ს მიერ მომხმარებლის მხრიდან მოდალის დახურვის შემთხვევაში.


- `onRequest` — function


  მეთოდი, რომელიც გამოიძახება SDK-ს მიერ მომხმარებლის მიერ პირობების არჩევის შემდეგ. ამ დროს უნდა მოხდეს განვადების [შეკვეთის მოთხოვნა](https://api.bog.ge/docs/docs/payments/standard-process/create-order). უნდა დაისეტოს `config.loan` პარამეტრი.
  მეთოდს გადმოეცემა არგუმენტები:
  - `selected` - ობიექტი, რომელშიც გადმოეცემა მომხმარებლის მიერ არჩეული მონაცემები.
      - `amount` - ყოველთვე გადასახდელი თანხა
      - `month` - სესხის თვეების რაოდენობა
      - `discount_code` - ფასდაკლების კოდი
  - `successCb` - მეთოდი, რომელიც უნდა გამოიძახოთ, თუ გსურთ, რომ განვადების პროცესი SDK-მ გააგრძელოს.
  - `closeCb` - მეთოდი, რომელიც უნდა გამოიძახოთ, თუ გსურთ მოდალის დახურვა.



- `onComplete` — function


  მეთოდი, რომელიც გამოიძახება SDK-ს მიერ ონლაინ განვადების პროცესის დასრულების შემდეგ. ამ დროს მომხმარებლის გადამისამართება ავტომატურად ხდება მერჩანტის წარმატების ლინკზე. თუ გსურთ, რომ არ მოხდეს გადამისამართება, მათოდში დააბრუნეთ `false` მნიშვნელობა (`return false;`).
  მეთოდს არტუმენტად გადმოეცემა ობიექტი, პარამეტრებით:
  - `redirectUrl` - ლინკი, სადაც უნდა გადამისამართდეს მომხარებელი.




### არსებობს პროცესის გაგრძელების ორი მეთოდი.
1. თუ გსურთ, რომ ონლაინ განვადების პროცესის გაგრძელება მოხდეს SDK-ს მიერ, `onRequest` მეთოდში, orderId-ის [გენერაციის შემდეგ](https://api.bog.ge/docs/docs/payments/standard-process/create-order), გამოიძახეთ `successCb`, რომელსაც გადასცემთ დაგენერირებულ `orderId` პარამეტრს. პროცესის დასრულების შემდეგ, გამოიძახება `onComplete` მეთოდი.
2. თუ SDK მხოლოდ კალკულატორისთვის გჭირდებათ და მომხმარებლის მიერ სასურველი პირობის არჩევის შემდეგ თქვენ თვითონ გააგრძელებინოთ მომხმარებელს პროცესი, `onRequest` მეთოდში დააბრუნეთ `false` მნიშვნელობა (`return false;`), რა დროსაც SDK პროცესს აღარ გააგრძელებს. ამ დროს მოდალი ღია რჩება. თუ გსურთ მოდალის დახურვა, გამოიყენეთ `closeCb` ან `Bog.Calculator.close()` მეთოდი





```js
BOG.Calculator.open({
    amount: 500,
    onClose: () => {
        // Modal close callback
    },
    onRequest: (selected, successCb, closeCb) => {
        const {
          amount, month, discount_code
        } = selected;
        fetch('url-to-backend-api', {
            method: 'POST',
            body: JSON.stringify(selected)
        })
        .then(response => response.json())
        .then(data => successCb(data.orderId))
        .catch(err => closeCb());
    },
    onComplete: ({redirectUrl}) => {
        return false;
    }
})
```






---

SDK ასევე საშუალებას გაძლევთ თქვენს საიტზე დაამატოთ საქართველოს ბანკის ღილაკი. მეთოდს გადაეცით DOM ელემენტი, სადაც გსურთ ღილაკის ჩასმა.

```html
<div class="bog-smart-button">
<script>
    const button = BOG.SmartButton.render(document.querySelector('.bog-smart-button'), {
        text: 'მოითხოვე სესხი',
        onClick: () => {
            // Open Installment Calculator Here
        }
    })
</script>
```