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

package/dist/shared/constants/paymentMethodAPM.d.ts

@@ -0,0 +1,62 @@
+declare const PAYMENT_METHOD_APM: Readonly<{
+    SORIANA: "SORIANA";
+    OXXO: "OXXO";
+    SPEI: "SPEI";
+    CODI: "CODI";
+    MERCADOPAGO: "MERCADOPAGO";
+    PAYPAL: "PAYPAL";
+    COMERCIALMEXICANA: "COMERCIALMEXICANA";
+    BANCOMER: "BANCOMER";
+    WALMART: "WALMART";
+    BODEGA: "BODEGA";
+    SAMSCLUB: "SAMSCLUB";
+    SUPERAMA: "SUPERAMA";
+    CALIMAX: "CALIMAX";
+    EXTRA: "EXTRA";
+    CIRCULOK: "CIRCULOK";
+    SEVEN11: "7ELEVEN";
+    TELECOMM: "TELECOMM";
+    BANORTE: "BANORTE";
+    BENAVIDES: "BENAVIDES";
+    DELAHORRO: "DELAHORRO";
+    ELASTURIANO: "ELASTURIANO";
+    WALDOS: "WALDOS";
+    ALSUPER: "ALSUPER";
+    KIOSKO: "KIOSKO";
+    STAMARIA: "STAMARIA";
+    LAMASBARATA: "LAMASBARATA";
+    FARMROMA: "FARMROMA";
+    FARMUNION: "FARMUNION";
+    FARMATODO: "FARMATODO";
+    SFDEASIS: "SFDEASIS";
+    FARM911: "FARM911";
+    FARMECONOMICAS: "FARMECONOMICAS";
+    FARMMEDICITY: "FARMMEDICITY";
+    RIANXEIRA: "RIANXEIRA";
+    WESTERNUNION: "WESTERNUNION";
+    ZONAPAGO: "ZONAPAGO";
+    CAJALOSANDES: "CAJALOSANDES";
+    CAJAPAITA: "CAJAPAITA";
+    CAJASANTA: "CAJASANTA";
+    CAJASULLANA: "CAJASULLANA";
+    CAJATRUJILLO: "CAJATRUJILLO";
+    EDPYME: "EDPYME";
+    KASNET: "KASNET";
+    NORANDINO: "NORANDINO";
+    QAPAQ: "QAPAQ";
+    RAIZ: "RAIZ";
+    PAYSER: "PAYSER";
+    WUNION: "WUNION";
+    BANCOCONTINENTAL: "BANCOCONTINENTAL";
+    GMONEY: "GMONEY";
+    GOPAY: "GOPAY";
+    WU: "WU";
+    PUNTOSHEY: "PUNTOSHEY";
+    AMPM: "AMPM";
+    JUMBOMARKET: "JUMBOMARKET";
+    SMELPUEBLO: "SMELPUEBLO";
+    BAM: "BAM";
+    REFACIL: "REFACIL";
+    ACYVALORES: "ACYVALORES";
+}>;
+export { PAYMENT_METHOD_APM };

package/dist/shared/constants/tonderUrl.d.ts

@@ -0,0 +1,7 @@
+declare const TONDER_URL_BY_MODE: Readonly<{
+    production: "https://app.tonder.io";
+    sandbox: "https://sandbox.tonder.io";
+    stage: "https://stage.tonder.io";
+    development: "http://localhost:8000";
+}>;
+export { TONDER_URL_BY_MODE };

package/dist/types/card.d.ts

@@ -0,0 +1,29 @@
+export interface ICard {
+    fields: ICardSkyflowFields;
+    icon?: string;
+}
+export interface ICardSkyflowFields {
+    card_number: string;
+    expiration_month: string;
+    expiration_year: string;
+    skyflow_id: string;
+    card_scheme: string;
+}
+export interface ICustomerCardsResponse {
+    user_id: number;
+    cards: ICard[];
+}
+export interface ISaveCardResponse {
+    skyflow_id: string;
+    user_id: number;
+}
+export interface ISaveCardSkyflowRequest {
+    skyflow_id: string;
+}
+export interface ISaveCardRequest {
+    card_number: string;
+    cvv: string;
+    expiration_month: string;
+    expiration_year: string;
+    cardholder_name: string;
+}

package/dist/types/checkout.d.ts

@@ -0,0 +1,103 @@
+import { ICustomer } from "./customer";
+export interface IStartCheckoutRequestBase {
+    name: any;
+    last_name: string;
+    email_client: any;
+    phone_number: any;
+    return_url?: string;
+    id_product: string;
+    quantity_product: number;
+    id_ship: string;
+    instance_id_ship: string;
+    amount: any;
+    title_ship: string;
+    description: string;
+    device_session_id: any;
+    token_id: string;
+    order_id: any;
+    business_id: any;
+    payment_id: any;
+    source: string;
+    browser_info?: any;
+    metadata: any;
+    currency: string;
+}
+export type IStartCheckoutRequestWithCard = IStartCheckoutRequestBase & {
+    card: any;
+    payment_method?: never;
+};
+export type IStartCheckoutRequestWithPaymentMethod = IStartCheckoutRequestBase & {
+    card?: never;
+    payment_method: string;
+};
+export type IStartCheckoutRequest = IStartCheckoutRequestWithCard | IStartCheckoutRequestWithPaymentMethod;
+export interface IStartCheckoutIdRequest {
+    checkout_id: string;
+}
+export interface IStartCheckoutErrorResponse {
+    status: string;
+    message: string;
+    psp_response: [
+        {
+            status: number;
+            response: Object;
+        }
+    ];
+    checkout_id: string;
+    is_route_finished: boolean;
+}
+export interface IStartCheckoutResponse {
+    status: string;
+    message: string;
+    psp_response: Record<string, any>;
+    checkout_id: string;
+    is_route_finished: Boolean;
+    transaction_status: string;
+    transaction_id: number;
+    payment_id: number;
+    provider: string;
+    next_action: {
+        redirect_to_url: {
+            url: string;
+            return_url: string;
+            verify_transaction_status_url: string;
+        };
+        iframe_resources?: {
+            iframe: string;
+        };
+    };
+    actions: IStartCheckoutActionResponse[];
+}
+export interface IStartCheckoutActionResponse {
+    name: string;
+    url: string;
+    method: string;
+}
+export interface IItem {
+    description: string;
+    quantity: number;
+    price_unit: number;
+    discount: number;
+    taxes: number;
+    product_reference: string | number;
+    name: string;
+    amount_total: number;
+}
+export interface IProcessPaymentRequest {
+    customer: ICustomer;
+    cart: {
+        total: string | number;
+        items: IItem[];
+    };
+    metadata?: Record<string, any>;
+    currency?: string;
+    payment_method?: string;
+    card?: ICardFields | string;
+}
+export interface ICardFields {
+    card_number: string;
+    cvv: string;
+    expiration_month: string;
+    expiration_year: string;
+    cardholder_name: string;
+}

package/dist/types/commons.d.ts

@@ -1,3 +1,4 @@
+import { ICustomer } from "./customer";
 export type Business = {
     business: {
         pk: number;
@@ -76,3 +77,34 @@ export type APM = {
     icon: string;
     label: string;
 };
+export interface IConfigureCheckout {
+    customer: ICustomer;
+}
+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;
+    apiKey: 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;
+    returnUrl: string;
+    callBack?: (response: any) => void;
+}
+export interface IApiError {
+    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;
+}

package/dist/types/customer.d.ts

@@ -0,0 +1,12 @@
+export type ICustomer = {
+    firstName: string;
+    lastName: string;
+    country?: string;
+    street?: string;
+    city?: string;
+    state?: string;
+    postCode?: string;
+    email: string;
+    phone?: string;
+    address?: string;
+};

package/dist/types/paymentMethod.d.ts

@@ -0,0 +1,22 @@
+export interface IPaymentMethodResponse {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: ITonderPaymentMethod[];
+}
+export interface ITonderPaymentMethod {
+    pk: string;
+    payment_method: string;
+    priority: number;
+    category: string;
+    unavailable_countries: string[];
+    status: string;
+}
+export interface IPaymentMethod {
+    id: string;
+    payment_method: string;
+    priority: number;
+    category: string;
+    icon: string;
+    label: string;
+}

package/dist/types/requests.d.ts

@@ -1,5 +1,5 @@
-import { OrderItem } from "./commons";
 import { SkyflowRecord } from "./skyflow";
+import { IItem } from "./checkout";
 export interface CreateOrderRequest {
     business: string;
     client: string;
@@ -9,7 +9,7 @@ export interface CreateOrderRequest {
     status?: string;
     reference: string | number;
     is_oneclick: boolean;
-    items: OrderItem[];
+    items: IItem[];
 }
 export type CreatePaymentRequest = {
     business_pk?: string | number;
@@ -61,6 +61,15 @@ export interface VaultRequest extends SkyflowRecord {
 export type RegisterCustomerCardRequest = {
     skyflow_id: string;
 };
+export type TokensSkyflowRequest = {
+    baseUrl: string;
+    apiKey: string;
+    vault_id: string;
+    vault_url: string;
+    data: {
+        [key: string]: any;
+    };
+};
 export type TokensRequest = {
     vault_id: string;
     vault_url: string;
@@ -70,7 +79,7 @@ export type TokensRequest = {
 };
 export type StartCheckoutFullRequest = {
     order: {
-        items: OrderItem[];
+        items: IItem[];
     };
     total: number;
     customer: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonder.io/ionic-lite-sdk",
-  "version": "0.0.34-beta.3",
+  "version": "0.0.35-beta.1",
   "description": "Tonder ionic lite SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/classes/BaseInlineCheckout.ts

@@ -0,0 +1,318 @@
+import {ThreeDSHandler} from "./3dsHandler";
+import {Business, IConfigureCheckout, IInlineCheckoutBaseOptions} from "../types/commons";
+import {ErrorResponse} from "./errorResponse";
+import {fetchBusiness} from "../data/businessApi";
+import {injectMercadoPagoSecurity} from "../helpers/mercadopago";
+import {TONDER_URL_BY_MODE} from "../shared/constants/tonderUrl";
+import {ICardFields, IItem, IProcessPaymentRequest, IStartCheckoutResponse} from "../types/checkout";
+import {StartCheckoutResponse} from "../types/responses";
+import {createOrder, createPayment, startCheckoutRouter} from "../data/checkoutApi";
+import {getOpenpayDeviceSessionID} from "../data/openPayApi";
+import {getBrowserInfo} from "../helpers/utils";
+import {registerOrFetchCustomer} from "../data/customerApi";
+import {ICustomer} from "../types/customer";
+
+export class BaseInlineCheckout {
+    baseUrl = "";
+    cartTotal = "0";
+    process3ds: ThreeDSHandler;
+    mode?: "production" | "sandbox" | "stage" | "development" | undefined;
+    apiKeyTonder: string;
+    returnUrl: string;
+    callBack?: ((response: any) => void) | undefined;
+    merchantData?: Business;
+    abortController: AbortController;
+
+    firstName?: string
+    lastName?: string
+    country?: string
+    address?: string
+    city?: string
+    state?: string
+    postCode?: string
+    email?: string
+    phone?: string
+    customer?: ICustomer
+
+    cartItems?: IItem[]
+    metadata = {}
+    card? = {}
+    currency?: string = ""
+
+    #customerData?: Record<string, any>;
+
+    constructor({ mode = "stage", apiKey, apiKeyTonder, returnUrl, callBack = () => {} }: IInlineCheckoutBaseOptions) {
+        this.apiKeyTonder = apiKey || apiKeyTonder || '';
+        this.returnUrl = returnUrl;
+        this.callBack = callBack;
+        this.mode = mode;
+        this.baseUrl = TONDER_URL_BY_MODE[this.mode] || TONDER_URL_BY_MODE["stage"];
+        this.abortController = new AbortController();
+        this.process3ds = new ThreeDSHandler({
+            apiKey: apiKey,
+            baseUrl: this.baseUrl,
+        });
+    }
+
+
+    configureCheckout(data: IConfigureCheckout) {
+        if ("customer" in data) this.#handleCustomer(data["customer"]);
+    }
+
+    async verify3dsTransaction () {
+        const result3ds = await this.process3ds.verifyTransactionStatus()
+        const resultCheckout = await this.#resumeCheckout(result3ds)
+        this.process3ds.setPayload(resultCheckout)
+        return this._handle3dsRedirect(resultCheckout)
+    }
+
+    payment(data: IProcessPaymentRequest): Promise<IStartCheckoutResponse> {
+        return new Promise(async (resolve, reject) => {
+            try {
+                this.#handleCustomer(data.customer);
+                this._setCartTotal(data.cart?.total);
+                this.#setCartItems(data.cart?.items);
+                this.#handleMetadata(data);
+                this.#handleCurrency(data);
+                this.#handleCard(data);
+                const response = await this._checkout(data);
+                this.process3ds.setPayload(response);
+                if(this.callBack)
+                    this.callBack!(response);
+                const payload = await this._handle3dsRedirect(response);
+                if (payload) {
+                    resolve(response);
+                }
+            } catch (error) {
+                reject(error);
+            }
+        });
+    }
+
+    async _initializeCheckout() {
+        const business_response = await this._fetchMerchantData();
+
+        if (!!business_response && !!business_response.mercado_pago && business_response.mercado_pago.active) {
+            injectMercadoPagoSecurity();
+        }
+    }
+
+    async _checkout(data: any): Promise<any> {
+        throw new Error(
+            "The #checkout method should be implement in child classes.",
+        );
+    }
+
+    _setCartTotal(total: string | number) {
+        throw new Error(
+            "The #setCartTotal method should be implement in child classes.",
+        );
+    }
+
+    async _getCustomer(signal: AbortSignal | null = null) {
+        if (!!this.#customerData) return this.#customerData!;
+
+        this.#customerData = await registerOrFetchCustomer(
+            this.baseUrl,
+            this.apiKeyTonder,
+            this.customer!,
+            signal
+        );
+        return this.#customerData!;
+    }
+
+    async _handleCheckout({ card, payment_method, customer, isSandbox }: {card?: string; payment_method?: string; customer: Record<string, any>; isSandbox?: boolean}) {
+        const { openpay_keys, reference, business } = this.merchantData!;
+        const total = Number(this.cartTotal);
+        try {
+            let deviceSessionIdTonder;
+            if (
+                !deviceSessionIdTonder &&
+                openpay_keys.merchant_id &&
+                openpay_keys.public_key
+            ) {
+                deviceSessionIdTonder = await getOpenpayDeviceSessionID(
+                    openpay_keys.merchant_id,
+                    openpay_keys.public_key,
+                    isSandbox,
+                    this.abortController.signal,
+                );
+            }
+
+            const { id, auth_token } = customer;
+
+            const orderItems = {
+                business: this.apiKeyTonder,
+                client: auth_token,
+                billing_address_id: null,
+                shipping_address_id: null,
+                amount: total,
+                status: "A",
+                reference: reference,
+                is_oneclick: true,
+                items: this.cartItems!,
+            };
+            const jsonResponseOrder = await createOrder(
+                this.baseUrl,
+                this.apiKeyTonder,
+                orderItems,
+            );
+
+            // Create payment
+            const now = new Date();
+            const dateString = now.toISOString();
+
+            const paymentItems = {
+                business_pk: business.pk,
+                client_id: id,
+                amount: total,
+                date: dateString,
+                order_id: jsonResponseOrder.id,
+            };
+            const jsonResponsePayment = await createPayment(
+                this.baseUrl,
+                this.apiKeyTonder,
+                paymentItems,
+            );
+
+            // Checkout router
+            const routerItems = {
+                name: this.firstName || "",
+                last_name: this.lastName || "",
+                email_client: this.email,
+                phone_number: this.phone,
+                return_url: this.returnUrl,
+                id_product: "no_id",
+                quantity_product: 1,
+                id_ship: "0",
+                instance_id_ship: "0",
+                amount: total,
+                title_ship: "shipping",
+                description: "transaction",
+                device_session_id: deviceSessionIdTonder ? deviceSessionIdTonder : null,
+                token_id: "",
+                order_id: jsonResponseOrder.id,
+                business_id: business.pk,
+                payment_id: jsonResponsePayment.pk,
+                source: "sdk",
+                metadata: this.metadata,
+                browser_info: getBrowserInfo(),
+                currency: this.currency!,
+                ...(!!payment_method ? { payment_method } : { card }),
+            };
+
+            const jsonResponseRouter = await startCheckoutRouter(
+                this.baseUrl,
+                this.apiKeyTonder,
+                routerItems,
+            );
+
+            if (jsonResponseRouter) {
+                return jsonResponseRouter;
+            } else {
+                return false;
+            }
+        } catch (error) {
+            console.log(error);
+            throw error;
+        }
+    }
+
+
+    async _fetchMerchantData() {
+        try {
+            if (!this.merchantData){
+                this.merchantData = await fetchBusiness(this.baseUrl, this.apiKeyTonder, this.abortController.signal);
+            }
+            return this.merchantData
+        }catch(e){
+            return this.merchantData
+        }
+    }
+
+    #handleCustomer(customer: ICustomer) {
+        if (!customer) return;
+
+        this.firstName = customer?.firstName;
+        this.lastName = customer?.lastName;
+        this.country = customer?.country;
+        this.address = customer?.street;
+        this.city = customer?.city;
+        this.state = customer?.state;
+        this.postCode = customer?.postCode;
+        this.email = customer?.email;
+        this.phone = customer?.phone;
+        this.customer = customer;
+    }
+
+    #setCartItems(items: IItem[]) {
+        this.cartItems = items;
+    }
+
+    #handleMetadata(data: { metadata?: any }) {
+        this.metadata = data?.metadata;
+    }
+
+    #handleCurrency(data: { currency?: string }) {
+        this.currency = data?.currency;
+    }
+
+    #handleCard(data: { card?: ICardFields | string }) {
+        this.card = data?.card;
+    }
+
+    // TODO: Make private after remove deprecated functions of liteCheckout
+    async _handle3dsRedirect(response: ErrorResponse | StartCheckoutResponse | false | undefined) {
+        const iframe = response && 'next_action' in response ? response?.next_action?.iframe_resources?.iframe:null
+
+        if (iframe) {
+            this.process3ds.loadIframe()!.then(() => {
+                //TODO: Check if this will be necessary on the frontend side
+                // after some the tests in production, since the 3DS process
+                // doesn't works properly on the sandbox environment
+                // setTimeout(() => {
+                //   process3ds.verifyTransactionStatus();
+                // }, 10000);
+                this.process3ds.verifyTransactionStatus();
+            }).catch((error) => {
+                console.log('Error loading iframe:', error)
+            })
+        } else {
+            const redirectUrl = this.process3ds.getRedirectUrl()
+            if (redirectUrl) {
+                this.process3ds.redirectToChallenge()
+            } else {
+                return response;
+            }
+        }
+    }
+
+    async #resumeCheckout(response: any) {
+        // Stop the routing process if the transaction is either hard declined or successful
+        if (response?.decline?.error_type === "Hard") {
+            return response
+        }
+
+        if (["Success", "Authorized"].includes(response?.transaction_status)) {
+            return response;
+        }
+
+        if (response) {
+            const routerItems = {
+                checkout_id: response.checkout?.id,
+            };
+
+            try{
+                return await startCheckoutRouter(
+                    this.baseUrl,
+                    this.apiKeyTonder,
+                    routerItems
+                )
+            }catch (error){
+                // throw error
+            }
+            return response
+        }
+    }
+
+}