@tonder.io/ionic-lite-sdk 0.0.35-beta.3 → 0.0.35-beta.31

package/src/index.ts

@@ -1,5 +1,13 @@
 import { LiteCheckout } from './classes/liteCheckout'
+import { BaseInlineCheckout } from './classes/BaseInlineCheckout'
+import { validateCVV, validateCardNumber, validateExpirationMonth, validateCardholderName, validateExpirationYear } from './helpers/validations'
 
 export {
-    LiteCheckout
+    LiteCheckout,
+    BaseInlineCheckout,
+    validateCVV,
+    validateCardNumber,
+    validateCardholderName,
+    validateExpirationMonth,
+    validateExpirationYear
 }

package/src/types/card.ts

@@ -9,6 +9,7 @@ export interface ICardSkyflowFields {
     expiration_year: string;
     skyflow_id: string;
     card_scheme: string;
+    cardholder_name: string;
 }
 
 export interface ICustomerCardsResponse {

package/src/types/checkout.ts

@@ -67,7 +67,7 @@ export interface IStartCheckoutResponse {
     payment_id: number;
     provider: string;
     next_action: {
-        redirect_to_url: {
+        redirect_to_url?: {
             url: string;
             return_url: string;
             verify_transaction_status_url: string;
@@ -107,6 +107,12 @@ export interface IProcessPaymentRequest {
     currency?: string;
     payment_method?: string;
     card?: ICardFields | string;
+    isSandbox?: boolean;
+    /**
+     * @deprecated This property is deprecated and will be removed in a future release.
+     * Use the `returnUrl` field when creating the instance of LiteCheckout or InlineCheckout.
+     */
+    returnUrl?: string;
 }
 
 export interface ICardFields {

package/src/types/commons.ts

@@ -1,125 +1,130 @@
-import {ICustomer} from "./customer";
+import { ICustomer } from "./customer";
+import {IStartCheckoutResponse} from "./checkout";
 
 export type Business = {
-    business: {
-        pk: number;
-        name: string;
-        categories: {
-            pk: number;
-            name: string;
-        }[];
-        web: string;
-        logo: string;
-        full_logo_url: string;
-        background_color: string;
-        primary_color: string;
-        checkout_mode: boolean;
-        textCheckoutColor: string;
-        textDetailsColor: string;
-        checkout_logo: string;
-    };
-    openpay_keys: {
-        merchant_id: string;
-        public_key: string;
-    };
-    fintoc_keys: {
-        public_key: string;
-    };
-    mercado_pago: {
-        active: boolean;
-    };
-    vault_id: string;
-    vault_url: string;
-    reference: number;
-    is_installments_available: boolean;
+  business: {
+    pk: number;
+    name: string;
+    categories: {
+      pk: number;
+      name: string;
+    }[];
+    web: string;
+    logo: string;
+    full_logo_url: string;
+    background_color: string;
+    primary_color: string;
+    checkout_mode: boolean;
+    textCheckoutColor: string;
+    textDetailsColor: string;
+    checkout_logo: string;
+  };
+  openpay_keys: {
+    merchant_id: string;
+    public_key: string;
+  };
+  fintoc_keys: {
+    public_key: string;
+  };
+  mercado_pago: {
+    active: boolean;
+  };
+  vault_id: string;
+  vault_url: string;
+  reference: number;
+  is_installments_available: boolean;
 };
 
 export type Customer = {
-    firstName: string;
-    lastName: string;
-    country: string;
-    street: string;
-    city: string;
-    state: string;
-    postCode: string;
-    email: string;
-    phone: string;
+  firstName: string;
+  lastName: string;
+  country: string;
+  street: string;
+  city: string;
+  state: string;
+  postCode: string;
+  email: string;
+  phone: string;
 };
 
 export type OrderItem = {
-    description: string;
-    quantity: number;
-    price_unit: number;
-    discount: number;
-    taxes: number;
-    product_reference: number;
-    name: string;
-    amount_total: number;
+  description: string;
+  quantity: number;
+  price_unit: number;
+  discount: number;
+  taxes: number;
+  product_reference: number;
+  name: string;
+  amount_total: number;
 };
 
 export type PaymentData = {
-    customer: Customer;
-    currency: string;
-    cart: {
-        total: string | number;
-        items: OrderItem[];
-    };
+  customer: Customer;
+  currency: string;
+  cart: {
+    total: string | number;
+    items: OrderItem[];
+  };
 };
 
 export type TonderAPM = {
-    pk: string;
-    payment_method: string;
-    priority: number;
-    category: string;
-    unavailable_countries: string[];
-    status: string;
-}
+  pk: string;
+  payment_method: string;
+  priority: number;
+  category: string;
+  unavailable_countries: string[];
+  status: string;
+};
 
 export type APM = {
-    id: string;
-    payment_method: string;
-    priority: number;
-    category: string;
-    icon: string;
-    label: string;
-}
-
+  id: string;
+  payment_method: string;
+  priority: number;
+  category: string;
+  icon: string;
+  label: string;
+};
 
 export interface IConfigureCheckout {
-    customer: ICustomer;
+  customer: ICustomer | { email: string };
 }
 
 export interface IInlineCheckoutBaseOptions {
-    mode?: "production" | "sandbox" | "stage" | "development";
-    /**
-     * @deprecated This property is deprecated and will be removed in a future release.
-     * `baseUrlTonder` is no longer required.
-     */
-    baseUrlTonder?: string;
-    /**
-     * @deprecated This property is deprecated and will be removed in a future release.
-     * Use `apiKey` instead, as `apiKeyTonder` is no longer required.
-     */
-    apiKeyTonder?: string;
-    /**
-     * @deprecated This property is deprecated and will be removed in a future release.
-     * `signal` is no longer required.
-     */
-    signal?: AbortSignal;
-    apiKey: string;
-    returnUrl: string;
-    callBack?: (response: any) => void;
+  mode?: "production" | "sandbox" | "stage" | "development";
+  /**
+   * @deprecated This property is deprecated and will be removed in a future release.
+   * `baseUrlTonder` is no longer required.
+   */
+  baseUrlTonder?: string;
+  /**
+   * @deprecated This property is deprecated and will be removed in a future release.
+   * Use `apiKey` instead, as `apiKeyTonder` is no longer required.
+   */
+  apiKeyTonder?: string;
+  /**
+   * @deprecated This property is deprecated and will be removed in a future release.
+   * `signal` is no longer required.
+   */
+  signal?: AbortSignal;
+  apiKey: string;
+  returnUrl?: string;
+  callBack?: (response: IStartCheckoutResponse | Record<string, any>) => void;
 }
+
+export interface IInlineLiteCheckoutOptions
+    extends IInlineCheckoutBaseOptions {}
+
+
 export interface IApiError {
-    code: string;
-    body: Record<string, string> | string;
-    name: string;
-    message: string;
+  code: string;
+  body: Record<string, string> | string;
+  name: string;
+  message: string;
 }
 
 export interface IPublicError {
-    status: string;
-    code: number;
-    message: string;
-    detail: Record<string, any> | string;
-}
+  status: string;
+  code: number;
+  message: string;
+  detail: Record<string, any> | string;
+}

package/src/types/customer.ts

@@ -1,4 +1,14 @@
 export type ICustomer = {
+    /**
+     * @deprecated This property is deprecated and will be removed in a future release.
+     * Use `firstName` instead, as `name` is no longer required.
+     */
+    name?: string;
+    /**
+     * @deprecated This property is deprecated and will be removed in a future release.
+     * Use `lastName` instead, as `lastname` is no longer required.
+     */
+    lastname?: string;
     firstName: string;
     lastName: string;
     country?: string;

package/src/types/liteInlineCheckout.ts

@@ -0,0 +1,215 @@
+import { IConfigureCheckout, IInlineCheckoutBaseOptions } from "./commons";
+import {
+  ICustomerCardsResponse,
+  ISaveCardRequest,
+  ISaveCardResponse,
+} from "./card";
+import { IPaymentMethod } from "./paymentMethod";
+import { IProcessPaymentRequest, IStartCheckoutResponse } from "./checkout";
+import { ITransaction } from "./transaction";
+import { APM } from "./commons";
+import { ErrorResponse } from "../classes/errorResponse";
+import {
+  CreateOrderRequest,
+  CreatePaymentRequest,
+  RegisterCustomerCardRequest,
+  StartCheckoutFullRequest,
+  StartCheckoutIdRequest,
+  StartCheckoutRequest,
+  TokensRequest,
+} from "./requests";
+import {
+  CreateOrderResponse,
+  CreatePaymentResponse,
+  CustomerRegisterResponse,
+  GetBusinessResponse,
+  RegisterCustomerCardResponse,
+  StartCheckoutResponse,
+} from "./responses";
+
+export interface ILiteCheckout {
+
+  /**
+   * The configureCheckout function allows you to set initial information, such as the customer's email, which is used to retrieve a list of saved cards.
+   * @param {import("./index").IConfigureCheckout} data - Configuration data including customer information and potentially other settings.
+   * @returns {Promise<void>}.
+   * @public
+   */
+  configureCheckout(data: IConfigureCheckout): void;
+
+  /**
+   * Initializes and prepares the checkout for use.
+   * This method set up the initial environment.
+   * @returns {Promise<void>} A promise that resolves when the checkout has been initialized.
+   * @throws {Error} If there's any problem during the checkout initialization.
+   * @public
+   */
+  injectCheckout(): Promise<void>;
+
+  /**
+   * Processes a payment.
+   * @param {import("./index").IProcessPaymentRequest} data - Payment data including customer, cart, and other relevant information.
+   * @returns {Promise<import("./index").IStartCheckoutResponse>} A promise that resolves with the payment response or 3DS redirect or is rejected with an error.
+   *
+   * @throws {Error} Throws an error if the checkout process fails. The error object contains
+   * additional `details` property with the response from the server if available.
+   * @property {import("./index").IStartCheckoutErrorResponse} error.details - The response body from the server when an error occurs.
+   *
+   * @public
+   */
+  payment(data: IProcessPaymentRequest): Promise<IStartCheckoutResponse>;
+
+  /**
+   * Verifies the 3DS transaction status.
+   * @returns {Promise<import("./index").ITransaction | import("./index").IStartCheckoutResponse | void>} The result of the 3DS verification and checkout resumption.
+   * @public
+   */
+  verify3dsTransaction(): Promise<ITransaction | IStartCheckoutResponse | void>;
+
+  /**
+   * Retrieves the list of cards associated with a customer.
+   * @returns {Promise<import("./index").ICustomerCardsResponse>} A promise that resolves with the customer's card data.
+   *
+   * @throws {import("./index").IPublicError} Throws an error object if the operation fails.
+   *
+   * @public
+   */
+  getCustomerCards(): Promise<ICustomerCardsResponse>;
+
+  /**
+   * Saves a card to a customer's account. This method can be used to add a new card
+   * or update an existing one.
+   * @param {import("./index").ISaveCardRequest} card - The card information to be saved.
+   * @returns {Promise<import("./index").ISaveCardResponse>} A promise that resolves with the saved card data.
+   *
+   * @throws {import("./index").IPublicError} Throws an error object if the operation fails.
+   *
+   * @public
+   */
+  saveCustomerCard(card: ISaveCardRequest): Promise<ISaveCardResponse>;
+
+  /**
+   * Removes a card from a customer's account.
+   * @param {string} skyflowId - The unique identifier of the card to be deleted.
+   * @returns {Promise<string>} A promise that resolves when the card is successfully deleted.
+   *
+   * @throws {import("./index").IPublicError} Throws an error object if the operation fails.
+   *
+   * @public
+   */
+  removeCustomerCard(skyflowId: string): Promise<string>;
+
+  /**
+   * Retrieves the list of available Alternative Payment Methods (APMs).
+   * @returns {Promise<import("./index").IPaymentMethod[]>} A promise that resolves with the list of APMs.
+   *
+   * @throws {import("./index").IPublicError} Throws an error object if the operation fails.
+   *
+   * @public
+   */
+  getCustomerPaymentMethods(): Promise<IPaymentMethod[]>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * It is no longer necessary to use this method, now automatically handled
+   * during the payment process or when using card management methods.
+   *
+   * Retrieves the business information.
+   * @returns {Promise<import("./index").GetBusinessResponse>} A promise that resolves with the business information.
+   *
+   * @throws {import("./index").IPublicError} Throws an error object if the operation fails.
+   *
+   * @public
+   */
+  getBusiness(): Promise<GetBusinessResponse>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * It is no longer necessary to use this method as customer registration is now automatically handled
+   * during the payment process or when using card management methods.
+   */
+  customerRegister(
+    email: string,
+  ): Promise<CustomerRegisterResponse | ErrorResponse>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * It is no longer necessary to use this method as order creation is now automatically
+   * handled when making a payment through the `payment` function.
+   */
+  createOrder(
+    orderItems: CreateOrderRequest,
+  ): Promise<CreateOrderResponse | ErrorResponse>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * It is no longer necessary to use this method as payment creation is now automatically
+   * handled when making a payment through the `payment` function.
+   */
+  createPayment(
+    paymentItems: CreatePaymentRequest,
+  ): Promise<CreatePaymentResponse | ErrorResponse>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * Use the {@link payment} method
+   */
+  startCheckoutRouter(
+    routerData: StartCheckoutRequest | StartCheckoutIdRequest,
+  ): Promise<StartCheckoutResponse | ErrorResponse | undefined>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * Use the {@link payment} method
+   */
+  startCheckoutRouterFull(
+    routerFullData: StartCheckoutFullRequest,
+  ): Promise<StartCheckoutResponse | ErrorResponse | undefined>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * Use the {@link saveCustomerCard} method
+   */
+  registerCustomerCard(
+    customerToken: string,
+    data: RegisterCustomerCardRequest,
+  ): Promise<RegisterCustomerCardResponse | ErrorResponse>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * Use the {@link removeCustomerCard} method
+   */
+  deleteCustomerCard(
+    customerToken: string,
+    skyflowId: string,
+  ): Promise<Boolean | ErrorResponse>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * Use the {@link getCustomerPaymentMethods} method
+   */
+  getActiveAPMs(): Promise<APM[]>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * It is no longer necessary to use this method as card registration or as checkout is now automatically handled
+   * during the payment process or when using card management methods.
+   */
+  getSkyflowTokens({
+    vault_id,
+    vault_url,
+    data,
+  }: TokensRequest): Promise<any | ErrorResponse>;
+
+  /**
+   * @deprecated This method is deprecated and will be removed in a future release.
+   * It is no longer necessary to use this method is now automatically handled
+   * during the payment process.
+   */
+  getOpenpayDeviceSessionID(
+    merchant_id: string,
+    public_key: string,
+    is_sandbox: boolean,
+  ): Promise<string | ErrorResponse>;
+}
+

package/src/types/transaction.ts

@@ -0,0 +1,101 @@
+export interface ITransaction {
+    id: number;
+    provider: string;
+    country: string;
+    currency_code: string;
+    transaction_status: string;
+    created: string;
+    modified: string;
+    operation_date: string;
+    transaction_reference: string;
+    transaction_type: string;
+    status: string;
+    amount: string;
+    related_transaction_reference?: null | string;
+    reason?: null | string;
+    is_refunded?: null | boolean;
+    is_disputed?: null | boolean;
+    number_of_payment_attempts: number;
+    card_brand?: null | string;
+    number_of_installments: number;
+    payment?: {
+        id: number;
+        created: string;
+        modified: string;
+        amount: string;
+        status: string;
+        date: string;
+        paid_date: null | string;
+        source: null | string;
+        customer_order_reference: null | string;
+        client: number;
+        business: number;
+        shipping_address?: null | string;
+        billing_address?: null | string;
+        order: number;
+    };
+    checkout: {
+        id: string;
+        created: string;
+        modified: string;
+        checkout_data: {
+            name: string;
+            amount: number;
+            source: string;
+            id_ship: string;
+            currency: string;
+            order_id: number;
+            token_id: string;
+            last_name: string;
+            id_product: string;
+            ip_address: string;
+            payment_id: number;
+            return_url: string;
+            title_ship: string;
+            business_id: number;
+            checkout_id: string;
+            description: string;
+            browser_info: {
+                language: string;
+                time_zone: number;
+                user_agent: string;
+                color_depth: number;
+                screen_width: number;
+                screen_height: number;
+                javascript_enabled: boolean;
+            };
+            email_client: string;
+            phone_number: string;
+            instance_id_ship: string;
+            quantity_product: number;
+            device_session_id: null | string;
+            number_of_payment_attempts: number;
+        };
+        number_of_payment_attempts: number;
+        tried_psps: string[];
+        rejected_transactions: string[];
+        routing_step: number;
+        route_length: number;
+        last_status: string;
+        ip_address: string;
+        is_dynamic_routing: boolean;
+        is_route_finished: boolean;
+        business: number;
+        payment: number;
+    };
+    currency: {
+        id: number;
+        name: string;
+        code: string;
+        symbol: string;
+        country: null | string;
+    };
+    payment_method?: null | {
+        id: number;
+        name: string;
+        display_name: string;
+        category: string;
+        is_apm: boolean;
+    };
+    issuing_country?: null | string;
+}

package/tests/classes/liteCheckout.test.ts

@@ -1,7 +1,7 @@
 import "../utils/defaultMock";
 import { LiteCheckout } from "../../src";
-import { LiteCheckoutConstructor } from "../../src/classes/liteCheckout";
 import { constructorFields } from "../utils/defaultMock";
+import {IInlineLiteCheckoutOptions} from "../../src/types/commons";
 
 declare global {
     interface Window {
@@ -11,7 +11,7 @@ declare global {
 }
 
 describe("LiteCheckout", () => {
-    let checkoutConstructor: LiteCheckoutConstructor,
+    let checkoutConstructor: IInlineLiteCheckoutOptions,
         liteCheckout: LiteCheckout,
         fetchSpy: jest.SpyInstance,
         liteCheckoutSpy: jest.SpyInstance;

package/tests/methods/createOrder.test.ts

@@ -1,10 +1,9 @@
 import "../utils/defaultMock";
 import { LiteCheckout } from "../../src";
 import { ErrorResponse } from "../../src/classes/errorResponse";
-import { LiteCheckoutConstructor } from "../../src/classes/liteCheckout";
-import { IErrorResponse } from "../../src/types/responses";
 import { constructorFields } from "../utils/defaultMock";
-import { OrderResponseClass, OrderClass, OrderClassEmptyValues, OrderEmptyValuesResponse } from "../utils/mockClasses";
+import { OrderResponseClass, OrderClass, OrderEmptyValuesResponse } from "../utils/mockClasses";
+import {IInlineLiteCheckoutOptions} from "../../src/types/commons";
 
 declare global {
     interface Window {
@@ -14,7 +13,7 @@ declare global {
 }
 
 describe("createOrder", () => {
-    let checkoutConstructor: LiteCheckoutConstructor,
+    let checkoutConstructor: IInlineLiteCheckoutOptions,
         liteCheckout: LiteCheckout,
         fetchSpy: jest.SpyInstance,
         liteCheckoutSpy: jest.SpyInstance;

package/tests/methods/createPayment.test.ts

@@ -1,10 +1,9 @@
 import "../utils/defaultMock";
 import { LiteCheckout } from "../../src";
 import { ErrorResponse } from "../../src/classes/errorResponse";
-import { LiteCheckoutConstructor } from "../../src/classes/liteCheckout";
-import { IErrorResponse } from "../../src/types/responses";
 import { constructorFields } from "../utils/defaultMock";
 import { CreatePaymentResponseClass, CreatePaymentRequestClass } from "../utils/mockClasses";
+import {IInlineLiteCheckoutOptions} from "../../src/types/commons";
 
 
 declare global {
@@ -15,7 +14,7 @@ declare global {
 }
 
 describe("createPayment", () => {
-    let checkoutConstructor: LiteCheckoutConstructor,
+    let checkoutConstructor: IInlineLiteCheckoutOptions,
         liteCheckout: LiteCheckout,
         fetchSpy: jest.SpyInstance,
         liteCheckoutSpy: jest.SpyInstance;