choco-one-click-payment 1.1.16 → 1.1.18

package/README.md

@@ -83,10 +83,11 @@ const ChocoOneClickWidget = require('choco-one-click-payment');
 | `backlink` | string | нет | URL для возврата после оплаты (Kaspi Pay, 3DS) |
 | `locale` | string | нет | Язык: ru, en, kk (по умолчанию ru) |
 | `preorderId` | number | нет | Preorder ID |
+| `containerSelector` | string | нет | CSS-селектор элемента для embedded-режима. Если не передан или элемент не найден — виджет монтируется sticky поверх страницы |
 | `color` | string | нет | Акцентный цвет (по умолчанию #2F2F2F) |
 | `onlyKaspiAvailable` | boolean | нет | Только Kaspi в списке способов оплаты |
 | `disableKaspi` | boolean | нет | Скрыть Kaspi среди способов оплаты |
-| `bonuses` | { amount: number, percent: number } | нет | Бонусы для ЗПЛ |
+| `bonuses` | { amount: number, percent: number } | нет | Бонусы: `amount` — сумма скидки в тиынах, `percent` — процент кэшбека. Виджет сам вычитает `amount` из итоговой суммы при включённом тоггле бонусов |
 
 ### Callbacks
 
@@ -98,7 +99,7 @@ const ChocoOneClickWidget = require('choco-one-click-payment');
 | `onConfirmPay` | Callback перед оплатой; получает выбранный `method`, для подтверждения вызовите `widget.pay()` |
 | `onPaymentMethodSelected` | Вызывается при выборе способа оплаты; получает выбранный `method` |
 | `onKaspiLink` | Вызывается для `kaspi_pay` при получении `action_link`/`action_url`; позволяет клиенту самому открыть ссылку |
-| `onAppliedBonus` | Вызывается при включении/выключении бонусов |
+| `onAppliedBonus` | Вызывается при включении/выключении бонусов тоггл-переключателем |
 | `onUserEvent` | Вызывается при пользовательских событиях виджета (`one_click_pay_cta_rendered`, `one_click_pay_method_resolved`, `one_click_pay_cta_tapped`) |
 
 ## Методы
@@ -125,6 +126,29 @@ const ChocoOneClickWidget = require('choco-one-click-payment');
 | `onUserEvent(callback)` | Регистрирует callback для пользовательских событий виджета. |
 | `pay()` | Подтверждает оплату и запускает создание заказа (после onConfirmPay). |
 
+### Режим монтирования: embedded vs sticky
+
+По умолчанию виджет монтируется как sticky-плашка поверх страницы (фиксированная снизу).
+
+Если передать `containerSelector` и элемент с таким селектором существует в DOM — виджет монтируется внутрь этого элемента (embedded-режим). Если селектор не передан или элемент не найден — применяется fallback: sticky поверх страницы.
+
+```javascript
+new ChocoOneClickWidget({
+  // ...
+  containerSelector: "#checkout-widget-slot",
+});
+```
+
+```html
+<div id="checkout-widget-slot"></div>
+```
+
+### Отображение «вместо» для Apple Pay / Google Pay
+
+Когда выбран Apple Pay или Google Pay, виджет показывает итоговую сумму к оплате и опциональную строку «вместо X» (зачёркнутая полная цена).
+
+Строка появляется когда итоговая сумма к оплате меньше переданного `amount` — то есть когда активен тоггл баланса или тоггл бонусов. В строке «вместо» всегда отображается исходный `amount` (сумма до любых скидок).
+
 ### Обработка ссылки Kaspi Pay
 
 Для способа оплаты `kaspi_pay` виджет больше не обязан делать редирект сам.

package/index.d.ts

@@ -42,13 +42,7 @@ export interface ChocoOneClickConfig {
      */
     amount: number;
 
-    /**
-     * Сумма без учёта бонусов (для отображения зачёркнутой суммы).
-     * Необязательное поле.
-     */
-    amountWithoutBonuses?: number;
-
-    /**
+/**
      * Код валюты
      * @default "KZT"
      */
@@ -316,13 +310,7 @@ export default class ChocoOneClickWidget {
      */
     updateAmount(amount: number): Promise<void>;
 
-    /**
-     * Обновляет сумму без бонусов (в тиынах) для зачёркнутого отображения.
-     * Передайте null/undefined, чтобы вернуть fallback к обычной сумме.
-     */
-    setAmountWithoutBonuses(amountWithoutBonuses?: number | null): Promise<void>;
-
-    /**
+/**
      * Обновляет локаль интерфейса и перерисовывает виджет
      */
     updateLocale(locale: string): Promise<void>;