@bloonio/lokotro-pay 1.5.1 → 1.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloonio/lokotro-pay",
-  "version": "1.5.1",
+  "version": "1.6.0",
   "description": "Angular SDK for Lokotro Pay - Clean white-surface payment checkout with themeable brand colors and support for cards, mobile money, e-wallets, and more.",
   "keywords": [
     "angular",

package/types/bloonio-lokotro-pay.d.ts

@@ -51,6 +51,7 @@ declare enum LokotroPayScreenNavigation {
     MobileMoneyFormScreen = "mobilemoneyFormScreen",
     CardFormScreen = "cardFormScreen",
     BankTransferFormScreen = "bankTransferFormScreen",
+    BankTransferOfferScreen = "bankTransferOfferScreen",
     FlashFormScreen = "flashFormScreen",
     PaymentConfirmationScreen = "paymentConfirmationScreen",
     ProcessingScreen = "processingScreen",
@@ -168,6 +169,49 @@ interface LokotroCountry {
     phoneNumberPrefixes: LokotroPhonePrefix[];
 }
 
+/**
+ * Bank entity (city) model
+ */
+interface LokotroBankEntity {
+    id: string;
+    name: string;
+    countryFlag?: string;
+}
+/**
+ * Bank currency model
+ */
+interface LokotroBankCurrency {
+    id: string;
+    name: string;
+    code: string;
+    symbol?: string;
+}
+/**
+ * Bank account model
+ */
+interface LokotroBankAccount {
+    id: string;
+    identifier: string;
+    accountNumber: string;
+    accountLabel: string;
+    createdAt?: string;
+    refBank?: LokotroBank;
+    refCurrency?: LokotroBankCurrency;
+}
+/**
+ * Bank model
+ */
+interface LokotroBank {
+    id: string;
+    name: string;
+    abreviation: string;
+    bankLogoUrl: string;
+    hasRibNomenclatureConstraint: boolean;
+    ribAccountNumberFormatStr: string;
+    bankAccounts: LokotroBankAccount[];
+    entityAvailables: LokotroBankEntity[];
+}
+
 /**
  * Lokotro Pay - Core Models and Interfaces
  * Angular version of the Flutter Lokotro Pay plugin
@@ -620,6 +664,7 @@ interface LokotroPaymentState {
     selectedPaymentMethod?: LokotroPaymentMethod;
     error?: LokotroPayError;
     response?: LokotroPayResponse;
+    bankTransferOffer?: JsonRecord | null;
 }
 declare class LokotroPaymentService {
     private httpClient;
@@ -725,6 +770,27 @@ declare class LokotroPaymentService {
      * Get form screen for payment channel
      */
     private getFormScreenForChannel;
+    /**
+     * Fetch the banks / accounts / entities available for a bank-transfer
+     * selection. Calls the gateway's /payments/get-config-bank (the same endpoint
+     * the Flutter SDK uses) and maps the snake_case payload into the typed models.
+     * Returns a LokotroHttpResponse<LokotroBank[]> so the bank form can read
+     * response.isSuccess + response.data.
+     */
+    fetchAvailableBanks(): Observable<LokotroHttpResponse<LokotroBank[]>>;
+    /**
+     * Customer accepted the bank-transfer switch offer — re-collect with the
+     * method forced to bank_transfer (analogue of the Flutter re-init). Clears the
+     * offer first so the confirm screen doesn't flash again.
+     */
+    confirmBankTransferSwitch(): void;
+    /** Customer declined the switch — return to payment-method selection. */
+    declineBankTransferSwitch(): void;
+    private asArray;
+    private mapBank;
+    private mapBankAccount;
+    private mapBankEntity;
+    private mapBankCurrency;
     /**
      * Convert payment body to API request format
      */
@@ -936,6 +1002,10 @@ interface LokotroTranslations {
     accountLabel: string;
     bankTransferProofInstructions: string;
     confirmBankTransfer: string;
+    bankTransferSwitchTitle: string;
+    bankTransferSwitchMessage: string;
+    bankTransferSwitchConfirm: string;
+    bankTransferSwitchDecline: string;
     redirectingIn: string;
     tapToCancel: string;
 }
@@ -1050,6 +1120,8 @@ declare class LokotroPayCheckoutComponent implements OnInit, OnChanges, OnDestro
     onResendOtp(): void;
     onBack(): void;
     onCancel(): void;
+    onConfirmBankTransfer(): void;
+    onDeclineBankTransfer(): void;
     onClose(): void;
     onRetry(): void;
     onDone(): void;
@@ -1464,6 +1536,40 @@ declare const LOKOTRO_PAY_FEATURE_FLAGS: {
  */
 declare function visiblePaymentMethods(methods: LokotroPaymentMethod[]): LokotroPaymentMethod[];
 
+/**
+ * Lokotro Pay - Bank Transfer Form Component
+ */
+
+declare class LokotroBankTransferFormComponent implements OnInit {
+    private fb;
+    localization: LokotroLocalizationService;
+    private paymentService;
+    showUserInfoForm: boolean;
+    formSubmitted: EventEmitter<Record<string, unknown>>;
+    cancel: EventEmitter<void>;
+    bankTransferForm: FormGroup;
+    isLoading: boolean;
+    allBanks: LokotroBank[];
+    cities: LokotroBankEntity[];
+    filteredBanks: LokotroBank[];
+    accounts: LokotroBankAccount[];
+    selectedCity: LokotroBankEntity | null;
+    selectedBank: LokotroBank | null;
+    selectedAccount: LokotroBankAccount | null;
+    constructor(fb: FormBuilder, localization: LokotroLocalizationService, paymentService: LokotroPaymentService);
+    ngOnInit(): void;
+    private initForm;
+    private fetchBanks;
+    private extractCities;
+    onCityChange(): void;
+    onBankChange(): void;
+    onAccountChange(): void;
+    onSubmit(): void;
+    onCancel(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LokotroBankTransferFormComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LokotroBankTransferFormComponent, "lokotro-bank-transfer-form", never, { "showUserInfoForm": { "alias": "showUserInfoForm"; "required": false; }; }, { "formSubmitted": "formSubmitted"; "cancel": "cancel"; }, never, never, true, never>;
+}
+
 /**
  * Lokotro Pay - Payment Status Component
  * Entry point for tracking payment status by payment ID only
@@ -1594,5 +1700,5 @@ declare class LokotroPaymentStatusComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<LokotroPaymentStatusComponent, "lokotro-payment-status", never, { "statusConfig": { "alias": "statusConfig"; "required": false; }; "showHeader": { "alias": "showHeader"; "required": false; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; }; }, { "statusChange": "statusChange"; "paymentComplete": "paymentComplete"; "paymentFailed": "paymentFailed"; "onClose": "onClose"; "onDoneEvent": "onDoneEvent"; }, never, never, true, never>;
 }
 
-export { LOKOTRO_ENV_CONFIG, LOKOTRO_PAY_CONFIG, LOKOTRO_PAY_FEATURE_FLAGS, LokotroHttpClientService, LokotroLoadingComponent, LokotroLocalizationService, LokotroOtpVerificationComponent, LokotroPayApiResponseCode, LokotroPayApiResponseCodeInfo, LokotroPayChannel, LokotroPayChannelInfo, LokotroPayCheckoutComponent, LokotroPayColors, LokotroPayEnv, LokotroPayFillingInfo, LokotroPayLanguage, LokotroPayLanguageInfo, LokotroPayModule, LokotroPayResultScreen, LokotroPayScreenNavigation, LokotroPayScreenNavigationInfo, LokotroPaymentFormComponent, LokotroPaymentMethodSelectionComponent, LokotroPaymentService, LokotroPaymentStatus, LokotroPaymentStatusComponent, LokotroProcessingComponent, LokotroResultComponent, visiblePaymentMethods };
+export { LOKOTRO_ENV_CONFIG, LOKOTRO_PAY_CONFIG, LOKOTRO_PAY_FEATURE_FLAGS, LokotroBankTransferFormComponent, LokotroHttpClientService, LokotroLoadingComponent, LokotroLocalizationService, LokotroOtpVerificationComponent, LokotroPayApiResponseCode, LokotroPayApiResponseCodeInfo, LokotroPayChannel, LokotroPayChannelInfo, LokotroPayCheckoutComponent, LokotroPayColors, LokotroPayEnv, LokotroPayFillingInfo, LokotroPayLanguage, LokotroPayLanguageInfo, LokotroPayModule, LokotroPayResultScreen, LokotroPayScreenNavigation, LokotroPayScreenNavigationInfo, LokotroPaymentFormComponent, LokotroPaymentMethodSelectionComponent, LokotroPaymentService, LokotroPaymentStatus, LokotroPaymentStatusComponent, LokotroProcessingComponent, LokotroResultComponent, visiblePaymentMethods };
 export type { LokotroCheckoutConfig, LokotroHttpResponse, LokotroMerchantInfo, LokotroOtpVerifyRequest, LokotroOtpVerifyResponse, LokotroPayConfig, LokotroPayError, LokotroPayOnError, LokotroPayOnResponse, LokotroPayResponse, LokotroPayThemeConfig, LokotroPaymentBody, LokotroPaymentFormData, LokotroPaymentInfo, LokotroPaymentMethod, LokotroPaymentMethodListItem, LokotroPaymentStatusConfig, LokotroPaymentStatusResponse, LokotroPaymentSubmitRequest, LokotroPaymentSubmitResponse, LokotroTransactionDetails };