choco-one-click-payment 1.0.4 → 1.0.6

package/README.md

@@ -48,17 +48,24 @@ const ChocoOneClickWidget = require('choco-one-click-widget');
 - `backlink` - URL для возврата (опционально)
 - `locale` - ru, en, kk (по умолчанию ru, опционально)
 - `preorderId` - preorder_id заказа (опционально)
-- `disabled` - блокирует UI (опционально)
-- `loading` - загрузка и блокировка UI (опционально)
 - `color` - цвет background-а элементов (по умолчанию #2F2F2F, опционально)
 - `onlyKaspiAvailable` - отключает все способы оплат и оставляет только Kaspi (опционально)
 - `disableKaspi` - отключает оплату по kaspi (опционально)
+- `bonuses: { amount: number, percent: numbrr }` - для ЗПЛ (опционально)
 
 ## Методы
 
 - `onSuccess` - вызывается после успешной оплаты (опционально)
 - `onError` - вызывается в случае ошибки оплаты, резолвит текст ошибки (опционально)
 - `onCancel` - вызывается при timeout (опционально)
+- `onConfirmPay` - callback перед оплатой; должен вызвать `widget.pay()` для подтверждения
+- `updateAmount(amount)` - обновляет сумму оплаты и текст кнопки
+- `updateLocale(locale)` - обновляет язык интерфейса
+- `setLoading(boolean)` - включает/выключает loading-состояние
+- `setDisabled(boolean)` - включает/выключает блокировку интеракций
+- `setPreorderId(preorderId)` - обновляет `preorderId` во время жизни виджета
+- `setMerchantOrderId(merchantOrderId)` - обновляет `merchantOrderId` во время жизни виджета
+- `pay()` - подтверждает оплату и запускает создание заказа
 
 ## Сборка пакета (для разработчиков)
 

package/index.d.ts

@@ -84,16 +84,9 @@ export interface ChocoOneClickConfig {
     onCancel?: () => void;
 
     /**
-     * Отключает интерактивные действия виджета (оплата и выбор метода)
-     * @default false
-     */
-    disabled?: boolean;
-
-    /**
-     * Показывает состояние загрузки и блокирует интеракции виджета
-     * @default false
+     * Callback вызываемый при нажатии на кнопку оплаты
      */
-    loading?: boolean;
+    onConfirmPay?: () => void;
 
     /**
      * Акцентный цвет (фон кнопки оплаты и включенного тумблера баланса)
@@ -112,6 +105,21 @@ export interface ChocoOneClickConfig {
      * @default false
      */
     disableKaspi?: boolean;
+
+    /**
+     * Данные по бонусам для отображения бонусного блока в виджете.
+     * Если не переданы, бонусный блок не показывается.
+     */
+    bonuses?: {
+      /**
+       * Количество бонусов
+       */
+      amount: number;
+      /**
+       * Максимальный процент оплаты бонусами
+       */
+      percent: number;
+    };
 }
 
 export interface PaymentSuccessEvent {
@@ -245,6 +253,46 @@ export default class ChocoOneClickWidget {
      * Закрывает bottom sheet
      */
     closePaymentSheet(): void;
+
+    /**
+     * Обновляет сумму оплаты (в тиынах) и текст кнопки оплаты
+     */
+    updateAmount(amount: number): Promise<void>;
+
+    /**
+     * Обновляет локаль интерфейса и перерисовывает виджет
+     */
+    updateLocale(locale: 'ru' | 'en' | 'kk'): Promise<void>;
+
+    /**
+     * Включает/выключает состояние загрузки
+     */
+    setLoading(loading: boolean): Promise<void>;
+
+    /**
+     * Включает/выключает блокировку интеракций
+     */
+    setDisabled(disabled: boolean): Promise<void>;
+
+    /**
+     * Обновляет preorderId в рантайме
+     */
+    setPreorderId(preorderId: number | string): Promise<void>;
+
+    /**
+     * Обновляет merchantOrderId в рантайме
+     */
+    setMerchantOrderId(merchantOrderId: string | number): Promise<void>;
+
+    /**
+     * Регистрирует callback на подтверждение оплаты
+     */
+    onConfirmPay(callback: () => void): Promise<void>;
+
+    /**
+     * Подтверждает оплату после onConfirmPay и запускает создание заказа
+     */
+    pay(): Promise<void>;
 }
 
 /**