@cloudcommerce/app-vindi 2.49.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 E-Com Club Softwares para E-commerce <ti@e-com.club>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+# `@cloudcommerce/app-vindi`

package/events.js

@@ -0,0 +1 @@
+export * from './lib/vindi-events.js';

package/lib/index.d.ts

@@ -0,0 +1 @@
+export * from './vindi';

package/lib/index.js

@@ -0,0 +1,3 @@
+// eslint-disable-next-line import/prefer-default-export
+export * from './vindi.js';
+// # sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,cAAc,SAAS,CAAC"}

package/lib/vindi-events.d.ts

@@ -0,0 +1,5 @@
+import '@cloudcommerce/firebase/lib/init';
+import * as functions from 'firebase-functions/v1';
+export declare const vindi: {
+    webhook: functions.HttpsFunction;
+};

package/lib/vindi-events.js

@@ -0,0 +1,21 @@
+/* eslint-disable import/prefer-default-export */
+import '@cloudcommerce/firebase/lib/init';
+import * as functions from 'firebase-functions/v1';
+import config from '@cloudcommerce/firebase/lib/config';
+import handleVindiWebhook from '../lib-mjs/vindi-webhook.mjs';
+
+const { httpsFunctionOptions } = config.get();
+
+export const vindi = {
+  webhook: functions
+    .region(httpsFunctionOptions.region)
+    .runWith(httpsFunctionOptions)
+    .https.onRequest((req, res) => {
+      if (req.method !== 'POST') {
+        res.sendStatus(405);
+      } else {
+        handleVindiWebhook(req, res);
+      }
+    }),
+};
+// # sourceMappingURL=vindi-events.js.map

package/lib/vindi-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vindi-events.js","sourceRoot":"","sources":["../src/vindi-events.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,OAAO,kCAAkC,CAAC;AAC1C,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AACnD,OAAO,MAAM,MAAM,oCAAoC,CAAC;AACxD,OAAO,kBAAkB,MAAM,8BAA8B,CAAC;AAE9D,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;AAE9C,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,SAAS;SACf,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC;SACnC,OAAO,CAAC,oBAAoB,CAAC;SAC7B,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC5B,IAAI,GAAG,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC1B,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,kBAAkB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC,CAAC;CACL,CAAC"}

package/lib/vindi.d.ts

@@ -0,0 +1,4 @@
+import '@cloudcommerce/firebase/lib/init';
+import type { AppModuleBody } from '@cloudcommerce/types';
+export declare const listPayments: (modBody: AppModuleBody) => Promise<any>;
+export declare const createTransaction: (modBody: AppModuleBody) => Promise<any>;

package/lib/vindi.js

@@ -0,0 +1,12 @@
+import '@cloudcommerce/firebase/lib/init';
+import handleListPayments from '../lib-mjs/vindi-list-payments.mjs';
+import handleCreateTransaction from '../lib-mjs/vindi-create-transaction.mjs';
+
+export const listPayments = async (modBody) => {
+  return handleListPayments(modBody);
+};
+
+export const createTransaction = async (modBody) => {
+  return handleCreateTransaction(modBody);
+};
+// # sourceMappingURL=vindi.js.map

package/lib/vindi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vindi.js","sourceRoot":"","sources":["../src/vindi.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC;AAE1C,OAAO,kBAAkB,MAAM,oCAAoC,CAAC;AACpE,OAAO,uBAAuB,MAAM,yCAAyC,CAAC;AAE9E,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,OAAsB,EAAE,EAAE;IAC3D,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,EAAE,OAAsB,EAAE,EAAE;IAChE,OAAO,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC"}

package/lib-mjs/util/vindi-utils.mjs

@@ -0,0 +1,74 @@
+import axios from 'axios';
+
+export const addInstallments = (
+  amount,
+  installments,
+  gateway = {},
+  response = null,
+) => {
+  let maxInterestFree = !(installments.interest_free_min_amount > amount.total)
+    ? installments.max_interest_free : 0;
+  const maxInstallments = installments.max_number && maxInterestFree
+    ? Math.max(installments.max_number, maxInterestFree)
+    : installments.max_number || maxInterestFree;
+  if (maxInstallments > 1) {
+    // default installments option
+    if (!installments.monthly_interest) {
+      maxInterestFree = maxInstallments;
+    }
+    const minInstallment = installments.min_installment || 5;
+    if (response) {
+      response.installments_option = {
+        min_installment: minInstallment,
+        max_number: maxInterestFree || installments.max_number,
+        monthly_interest: maxInterestFree ? 0 : installments.monthly_interest,
+      };
+    }
+    // list installment options
+    gateway.installment_options = [];
+    for (let number = 2; number <= maxInstallments; number++) {
+      const tax = !(maxInterestFree >= number);
+      let interest;
+      if (tax) {
+        interest = installments.monthly_interest / 100;
+      }
+      const value = !tax ? amount.total / number
+        // https://pt.wikipedia.org/wiki/Tabela_Price
+        : amount.total * (interest / (1 - (1 + interest) ** -number));
+      if (value >= minInstallment) {
+        gateway.installment_options.push({
+          number,
+          value,
+          tax,
+        });
+      }
+    }
+  }
+  return { response, gateway };
+};
+
+export const parseVindiStatus = (vindiChargeStatus) => {
+  switch (vindiChargeStatus) {
+    case 'pending':
+    case 'paid':
+      return vindiChargeStatus;
+    case 'canceled':
+      return 'voided';
+    case 'processing':
+      return 'under_analysis';
+    case 'fraud_review':
+      return 'authorized';
+    default:
+  }
+  return 'unknown';
+};
+
+export const createVindiAxios = (vindiApiKey, isSandbox) => {
+  // https://vindi.github.io/api-docs/dist/
+  return axios.create({
+    baseURL: `https://${(isSandbox ? 'sandbox-' : '')}app.vindi.com.br/api/v1/`,
+    headers: {
+      Authorization: 'Basic ' + Buffer.from(`${vindiApiKey}:`).toString('base64'),
+    },
+  });
+};

package/lib-mjs/vindi-create-transaction.mjs

@@ -0,0 +1,282 @@
+import $config, { logger } from '@cloudcommerce/firebase/lib/config';
+import updateAppData from '@cloudcommerce/firebase/lib/helpers/update-app-data';
+import {
+  addInstallments,
+  createVindiAxios,
+  parseVindiStatus,
+} from './util/vindi-utils.mjs';
+
+export default async (modBody) => {
+  const { application, params } = modBody;
+  const appData = {
+    ...application.data,
+    ...application.hidden_data,
+  };
+  if (appData.vindi_api_key) {
+    process.env.VINDI_API_KEY = appData.vindi_api_key;
+  }
+  const { VINDI_API_KEY } = process.env;
+  if (!VINDI_API_KEY) {
+    return {
+      error: 'NO_VINDI_KEYS',
+      message: 'Chave de API e/ou criptografia não configurada (lojista deve configurar o aplicativo)',
+    };
+  }
+  const vindiAxios = createVindiAxios(VINDI_API_KEY, appData.vindi_sandbox);
+  const { storeId } = $config.get();
+
+  // https://apx-mods.e-com.plus/api/v1/create_transaction/schema.json?store_id=100
+  const orderId = params.order_id;
+  const {
+    amount, buyer, to, items,
+  } = params;
+  // https://apx-mods.e-com.plus/api/v1/create_transaction/response_schema.json?store_id=100
+  const transaction = {
+    amount: amount.total,
+  };
+
+  // must always create Vindi customer before
+  const vindiMetadata = {
+    order_number: params.order_number,
+    store_id: storeId,
+    order_id: orderId,
+    order_type: params.type,
+  };
+  const vindiCustomer = {
+    name: buyer.fullname,
+    email: buyer.email,
+    registry_code: buyer.doc_number,
+    code: `${buyer.customer_id}:${Date.now()}`,
+    phones: [{
+      phone_type: !buyer.phone.type || buyer.phone.type === 'personal' ? 'mobile' : 'landline',
+      number: `${(buyer.phone.country_code || '55')}${buyer.phone.number}`,
+    }],
+    notes: `E-Com Plus => Pedido #${params.order_number} em ${params.domain}`,
+    metadata: vindiMetadata,
+  };
+  const parseAddress = (_to) => ({
+    street: _to.street,
+    number: String(_to.number) || 'S/N',
+    additional_details: _to.complement,
+    zipcode: _to.zip,
+    neighborhood: _to.borough,
+    city: _to.city,
+    state: _to.province_code || _to.province,
+    country: _to.country_code || 'BR',
+  });
+  if (to && to.street) {
+    vindiCustomer.address = parseAddress(to);
+  } else if (params.billing_address) {
+    vindiCustomer.address = parseAddress(params.billing_address);
+  }
+
+  // strart mounting Vindi bill object
+  const vindiBill = {
+    code: String(params.order_number),
+    metadata: vindiMetadata,
+  };
+
+  let finalAmount = Math.floor(amount.total * 100) / 100;
+  if (params.payment_method.code === 'credit_card') {
+    let installmentsNumber = params.installments_number;
+    if (installmentsNumber > 1) {
+      if (appData.installments) {
+        // list all installment options
+        const { gateway } = addInstallments(amount, appData.installments);
+        const installmentOption = gateway.installment_options
+          && gateway.installment_options.find(({ number }) => number === installmentsNumber);
+        if (installmentOption) {
+          transaction.installments = installmentOption;
+          transaction.installments.total = Math.round(
+            installmentOption.number * installmentOption.value * 100,
+          ) / 100;
+          finalAmount = transaction.installments.total;
+        } else {
+          installmentsNumber = 1;
+        }
+      }
+    }
+    vindiBill.payment_method_code = 'credit_card';
+    vindiBill.installments = installmentsNumber;
+  } else {
+    // banking billet
+    vindiBill.payment_method_code = appData.banking_billet?.is_yapay
+      ? 'bank_slip_yapay' : 'bank_slip';
+  }
+
+  try {
+    const { data: vindiCustomerRes } = await vindiAxios({
+      url: '/customers',
+      method: 'post',
+      timeout: 12000,
+      data: vindiCustomer,
+    });
+    vindiBill.customer_id = vindiCustomerRes.customer?.id || vindiCustomerRes.id;
+
+    let vindiProductId = appData.vindi_product_id;
+    if (!vindiProductId) {
+      // must explicitly create a product before bill
+      const { data: vindiProductRes } = await vindiAxios({
+        url: '/products',
+        method: 'post',
+        timeout: 12000,
+        data: {
+          name: `Pedido na loja ${params.domain}`,
+          code: `ecomplus-${Date.now()}`,
+          status: 'active',
+          description: 'Produto pré-definido para pedidos através da plataforma E-Com Plus',
+          pricing_schema: {
+            price: 100,
+            schema_type: 'flat',
+          },
+        },
+      });
+      vindiProductId = vindiProductRes.product?.id || vindiProductRes.id;
+      await updateAppData(application, {
+        vindi_product_id: vindiProductId,
+      }, {
+        isHiddenData: true,
+        canSendPubSub: false,
+      });
+    }
+
+    if (params.credit_card && params.credit_card.hash) {
+      vindiBill.payment_profile = {
+        payment_method_code: vindiBill.payment_method_code,
+        allow_as_fallback: true,
+        gateway_token: params.credit_card.hash,
+      };
+      if (params.payer && params.payer.doc_number) {
+        vindiBill.payment_profile.registry_code = params.payer.doc_number;
+      }
+    }
+
+    if (params.type === 'recurrence') {
+      // async handle plan subscription
+      // must register all products and a plan on Vindi
+      // check products metadata to prevent duplication
+      return {
+        data: {
+          id: 0,
+          charges: [{
+            id: 0,
+            status: 'pending',
+          }],
+        },
+      };
+    }
+
+    /*
+    "Apesar do bill_item suportar um esquema de precificação (pricing_schema)
+    com quantidade (quantity), recomendamos utilizar apenas o parâmetro
+    amount para evitar complexidade desnecessária no desenvolvimento.
+    Se pricing_schema, quantity e amount forem informados ao mesmo tempo,
+    garanta que todos sejam mutuamente válidos"
+    */
+    // create a product for current order
+    let description = '';
+    if (items.length === 1) {
+      description = `${items[0].quantity}x ${items[0].sku} - ${items[0].name}`;
+    } else {
+      items.forEach(({ quantity, sku }) => {
+        description += `${quantity}x ${sku}; `;
+      });
+    }
+    if (description.length > 255) {
+      description = description.substring(0, 250) + ' ...';
+    }
+    vindiBill.bill_items = [{
+      product_id: vindiProductId,
+      amount: finalAmount,
+      description,
+    }];
+    // create Vindi single bill
+    const { data: vindiBillRes } = await vindiAxios({
+      url: '/bills',
+      method: 'post',
+      data: vindiBill,
+    });
+
+    const createdBill = vindiBillRes.bill || vindiBillRes;
+    const vindiCharge = createdBill.charges[0];
+    if (vindiCharge.amount) {
+      transaction.amount = Number(vindiCharge.amount);
+    }
+    transaction.intermediator = {
+      buyer_id: String(vindiBill.customer_id),
+      transaction_code: String(vindiCharge.id),
+      transaction_reference: String(createdBill.id),
+    };
+
+    if (vindiCharge.payment_method) {
+      transaction.intermediator.payment_method = {
+        code: vindiCharge.payment_method.code || params.payment_method.code,
+      };
+      if (vindiCharge.payment_method.name) {
+        transaction.intermediator.payment_method.name = vindiCharge.payment_method.name;
+      }
+    }
+    if (vindiCharge.print_url) {
+      transaction.payment_link = vindiCharge.print_url;
+      if (params.payment_method.code === 'banking_billet') {
+        transaction.banking_billet = {
+          link: vindiCharge.print_url,
+        };
+      }
+    }
+
+    const vindiTransaction = vindiCharge.last_transaction;
+    if (vindiTransaction) {
+      transaction.intermediator.transaction_id = String(vindiTransaction.id);
+      if (vindiTransaction.payment_profile && vindiTransaction.payment_profile.token) {
+        transaction.credit_card = {
+          token: vindiTransaction.payment_profile.token,
+        };
+        if (vindiTransaction.payment_profile.card_number_last_four) {
+          transaction.credit_card.last_digits = vindiTransaction
+            .payment_profile.card_number_last_four;
+        }
+        if (vindiTransaction.payment_profile.payment_company) {
+          transaction.credit_card.company = vindiTransaction
+            .payment_profile.payment_company.name;
+        }
+      }
+    }
+
+    transaction.status = {
+      updated_at: vindiBillRes.updated_at || vindiBillRes.created_at || new Date().toISOString(),
+      current: parseVindiStatus(vindiCharge.status),
+    };
+    return { transaction };
+  } catch (error) {
+    // try to debug request error
+    const errCode = 'VINDI_BILL_ERR';
+    let { message } = error;
+    const err = new Error(`${errCode} ${orderId} => ${message}`);
+    if (error.response) {
+      const { status, data } = error.response;
+      if (status !== 401 && status !== 403) {
+        if (error.config) {
+          err.url = error.config.url;
+          err.data = error.config.data;
+        } else {
+          err.bill = JSON.stringify(vindiBill);
+        }
+        err.customer = JSON.stringify(vindiCustomer);
+        err.status = status;
+        if (typeof data === 'object' && data) {
+          err.response = JSON.stringify(data);
+        } else {
+          err.response = data;
+        }
+      } else if (data?.errors?.[0]?.message) {
+        message = data.errors[0].message;
+      }
+    }
+    logger.error(err);
+    return {
+      error: errCode,
+      message,
+    };
+  }
+};

package/lib-mjs/vindi-list-payments.mjs

@@ -0,0 +1,152 @@
+import { addInstallments } from './util/vindi-utils.mjs';
+
+export default async (modBody) => {
+  const { application, params } = modBody;
+  const appData = {
+    ...application.data,
+    ...application.hidden_data,
+  };
+  if (appData.vindi_api_key) {
+    process.env.VINDI_API_KEY = appData.vindi_api_key;
+  }
+  if (appData.vindi_public_key) {
+    process.env.VINDI_PUBLIC_KEY = appData.vindi_public_key;
+  }
+  const { VINDI_API_KEY, VINDI_PUBLIC_KEY } = process.env;
+  if (!VINDI_API_KEY || !VINDI_PUBLIC_KEY) {
+    return {
+      error: 'NO_VINDI_KEYS',
+      message: 'Chave de API e/ou criptografia não configurada (lojista deve configurar o aplicativo)',
+    };
+  }
+
+  // https://apx-mods.e-com.plus/api/v1/list_payments/schema.json?store_id=100
+  const amount = params.amount || {};
+  // https://apx-mods.e-com.plus/api/v1/list_payments/response_schema.json?store_id=100
+  const response = {
+    payment_gateways: [],
+  };
+
+  const { discount } = appData;
+  if (discount && discount.value > 0) {
+    if (discount.apply_at !== 'freight') {
+      // default discount option
+      const { value } = discount;
+      response.discount_option = {
+        label: appData.discount_option_label,
+        value,
+      };
+      // specify the discount type and min amount is optional
+      ['type', 'min_amount'].forEach((prop) => {
+        if (discount[prop]) {
+          response.discount_option[prop] = discount[prop];
+        }
+      });
+    }
+
+    if (amount.total) {
+      // check amount value to apply discount
+      if (amount.total < discount.min_amount) {
+        discount.value = 0;
+      } else {
+        delete discount.min_amount;
+
+        // fix local amount object
+        const maxDiscount = amount[discount.apply_at || 'subtotal'];
+        let discountValue;
+        if (discount.type === 'percentage') {
+          discountValue = maxDiscount * (discount.value / 100);
+        } else {
+          discountValue = discount.value;
+          if (discountValue > maxDiscount) {
+            discountValue = maxDiscount;
+          }
+        }
+        if (discountValue > 0) {
+          amount.discount = (amount.discount || 0) + discountValue;
+          amount.total -= discountValue;
+          if (amount.total < 0) {
+            amount.total = 0;
+          }
+        }
+      }
+    }
+  }
+
+  // common payment methods data
+  const intermediator = {
+    name: 'Vindi',
+    link: 'https://app.vindi.com.br/',
+    code: 'vindi_app',
+  };
+  const paymentTypes = [];
+  if (appData.enable_subscription) {
+    paymentTypes.push('recurrence');
+  }
+  if (!appData.disable_bill) {
+    paymentTypes.push('payment');
+  }
+
+  // setup payment gateway objects
+  ['credit_card', 'banking_billet'].forEach((paymentMethod) => {
+    paymentTypes.forEach((type) => {
+      const methodConfig = appData[paymentMethod] || {};
+      if (!methodConfig.disable) {
+        const isCreditCard = paymentMethod === 'credit_card';
+        let label = methodConfig.label || (isCreditCard ? 'Cartão de crédito' : 'Boleto bancário');
+        if (type === 'recurrence' && appData.subscription_label) {
+          label = appData.subscription_label + label;
+        }
+        const gateway = {
+          label,
+          icon: methodConfig.icon,
+          text: methodConfig.text,
+          payment_method: {
+            code: paymentMethod,
+            name: `${label} - ${intermediator.name}`,
+          },
+          type,
+          intermediator,
+        };
+
+        if (isCreditCard) {
+          if (!gateway.icon) {
+            gateway.icon = 'https://ecom-pagarme5.web.app/credit-card.png';
+          }
+          gateway.js_client = {
+            // @TODO: Fix to a project controlled URL
+            script_uri: 'https://us-central1-ecom-vindi.cloudfunctions.net/app/vindi-hash.js',
+            onload_expression: `window._vindiKey="${VINDI_PUBLIC_KEY}";`
+              + `window._vindiSandbox=${Boolean(appData.vindi_sandbox)};`,
+            cc_hash: {
+              function: '_vindiHash',
+              is_promise: true,
+            },
+          };
+          const { installments } = appData;
+          if (installments) {
+            // list all installment options and default one
+            addInstallments(amount, installments, gateway, response);
+          }
+        }
+
+        if (methodConfig.discount) {
+          gateway.discount = methodConfig.discount;
+        } else if (
+          discount
+          && (discount[paymentMethod] === true
+            || (!isCreditCard && discount[paymentMethod] !== false))
+        ) {
+          gateway.discount = discount;
+          if (response.discount_option && !response.discount_option.label) {
+            response.discount_option.label = label;
+          }
+        }
+
+        response.payment_gateways.push(gateway);
+      }
+    });
+  });
+
+  return response;
+};

package/lib-mjs/vindi-webhook.mjs

@@ -0,0 +1,108 @@
+import api from '@cloudcommerce/api';
+import { logger } from '@cloudcommerce/firebase/lib/config';
+import getAppData from '@cloudcommerce/firebase/lib/helpers/get-app-data';
+import { parseVindiStatus, createVindiAxios } from './util/vindi-utils.mjs';
+
+const handleVindiWebhook = async (req, res) => {
+  const vindiEvent = req.body?.event;
+  if (!vindiEvent?.data || !vindiEvent.type) {
+    return res.sendStatus(400);
+  }
+  if (vindiEvent.type === 'test') {
+    return res.sendStatus(200);
+  }
+  let vindiSandbox;
+  if (!process.env.VINDI_API_KEY) {
+    const appData = await getAppData('vindi');
+    process.env.VINDI_API_KEY = appData.vindi_api_key;
+    vindiSandbox = appData.vindi_sandbox;
+  }
+  const { VINDI_API_KEY } = process.env;
+  if (!VINDI_API_KEY) {
+    return res.sendStatus(403);
+  }
+  const data = vindiEvent.data.id
+    ? vindiEvent.data
+    : (vindiEvent.data.bill || vindiEvent.data.charge);
+  if (!data.id) {
+    logger.warn('Vindi Hook unexpected data:', { data });
+    return res.sendStatus(400);
+  }
+
+  logger.info(`Vindi Hook ${vindiEvent.type} ${data.id}`);
+  const isVindiCharge = vindiEvent.type.startsWith('charge_');
+  const axiosVindi = createVindiAxios(VINDI_API_KEY, vindiSandbox);
+  const { data: vindiBillRes } = await axiosVindi
+    .get('/bills/' + (isVindiCharge ? data.bill.id : data.id));
+  const vindiBill = vindiBillRes.bill || vindiBillRes;
+  if (!vindiBill?.charges?.[0]) {
+    logger.warn(`Vindi bill unset or unexpected for ${data.id}`, { vindiBill });
+    return res.sendStatus(204);
+  }
+  const vindiCharge = vindiBill.charges[0];
+
+  const ordersFilter = data.metadata?.order_id
+    ? `_id=${data.metadata.order_id}`
+    : `transactions.intermediator.transaction_code=${vindiCharge.id}`;
+  const {
+    data: { result: [order] },
+  } = await api.get(`orders?${ordersFilter}&fields=_id,transactions&limit=1`);
+  if (!order) {
+    logger.warn(`Order not found for ${vindiCharge.id}`, {
+      ordersFilter,
+      body: req.body,
+      vindiCharge,
+    });
+    return res.sendStatus(204);
+  }
+
+  let status;
+  switch (vindiEvent.type) {
+    case 'charge_rejected':
+      status = 'unauthorized';
+      break;
+    case 'charge_refunded':
+      status = 'refunded';
+      break;
+    default:
+      status = parseVindiStatus(vindiCharge.status);
+  }
+  // single bill
+  // async cancell Vindi bill when transaction is cancelled
+  switch (status) {
+    case 'voided':
+    case 'refunded':
+    case 'unauthorized':
+      axiosVindi.delete('/bills/' + vindiBill.id)
+        .catch((error) => {
+          if (error.response) {
+            const err = new Error('Delete bill error');
+            err.config = error.config;
+            err.data = JSON.stringify(error.response.data);
+            err.status = error.response.status;
+          } else {
+            logger.error(error);
+          }
+        });
+      break;
+    default:
+  }
+
+  const transaction = order.transactions?.find(({ intermediator }) => {
+    return intermediator?.transaction_code === String(vindiCharge.id);
+  });
+  if (transaction?._id) {
+    await api.post(`orders/${order._id}/payments_history`, {
+      date_time: new Date().toISOString(),
+      status,
+      transaction_id: transaction._id,
+      notification_code: vindiEvent.type + ';' + vindiEvent.created_at,
+      flags: ['vindi'],
+    });
+    logger.info(`Updated ${order._id} to ${status}`);
+    return res.sendStatus(201);
+  }
+  return res.sendStatus(200);
+};
+
+export default handleVindiWebhook;

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@cloudcommerce/app-vindi",
+  "type": "module",
+  "version": "2.49.0",
+  "description": "e-com.plus Cloud Commerce app to integrate Vindi Gateway",
+  "main": "lib/vindi.js",
+  "exports": {
+    ".": "./lib/vindi.js",
+    "./events": "./lib/vindi-events.js"
+  },
+  "files": [
+    "/lib",
+    "/lib-mjs",
+    "/assets",
+    "/types",
+    "/*.{js,mjs,ts}"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ecomplus/cloud-commerce.git",
+    "directory": "packages/apps/vindi"
+  },
+  "author": "E-Com Club Softwares para E-commerce <ti@e-com.club>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/ecomplus/cloud-commerce/issues"
+  },
+  "homepage": "https://github.com/ecomplus/cloud-commerce/tree/main/packages/apps/vindi#readme",
+  "dependencies": {
+    "axios": "^1.11.0",
+    "firebase-admin": "^13.4.0",
+    "firebase-functions": "^6.4.0",
+    "@cloudcommerce/api": "2.49.0",
+    "@cloudcommerce/firebase": "2.49.0"
+  },
+  "devDependencies": {
+    "@cloudcommerce/types": "2.49.0"
+  },
+  "scripts": {
+    "build": "bash ../../../scripts/build-lib.sh"
+  }
+}