@crm-rocketlink/crm-model 1.0.0 → 1.0.1

package/src/gateways/adapters/model/transactionFinXP.model.ts

@@ -0,0 +1,193 @@
+import { Transaction } from "../../../model/transaction.model";
+import { BANKS } from "../../../model/gateway.model";
+
+export type TransactionType = TransactionFinXP;
+
+export function isTransactionFinXP(t: Transaction): t is TransactionFinXP {
+  return t?.bank === BANKS.finXP;
+}
+
+export interface TransactionFinXP extends Transaction {
+  bank: typeof BANKS.finXP;
+  id?: number;
+  status?: string;
+  endToEndId?: string;
+  merchant?: string;
+  amount?: string;
+  effectiveDate?: string;
+  customerBic?: string;
+  customerIban?: string;
+  customerName?: string;
+  customerId?: string;
+  additionalInfo1?: string;
+  additionalInfo2?: string;
+  importedDate?: string;
+  mandateReference?: string;
+  transactionInformation?: string;
+  transactionTypeName?: string;
+  errorCode?: string;
+  importedFile?: string;
+  merchantProductName?: string;
+  bankFee?: string;
+  isChargeback?: string;
+  mandateDate?: string;
+  cb_status?: string;
+  cb_chargebackDate?: string;
+  cb_statementDate?: string;
+  cb_chargebackAmount?: string;
+  cb_initiatedAmount?: string;
+  cb_bankFees?: string;
+  cb_currency?: string;
+  cb_chargebackEntryInformation?: string;
+  cb_paymentAdviceIdentifier?: string;
+  cb_rejectCode?: string;
+  cb_chargebackRemittanceInformation?: string;
+  cb_chargebackReason?: string;
+  cb_paymentAdviceDate?: string;
+  cb_initiatedDate?: string;
+  cb_fileName?: string;
+  cb_sepaProduct?: string;
+  cb_product?: string;
+  cb_customerNumber?: string;
+  cb_customerName?: string;
+  cb_customerBic?: string;
+  cb_customerIban?: string;
+  cb_transactionInformation?: string;
+  cb_invoiceNumber?: string;
+  cb_additionalInformation?: string;
+  cb_additionalInformation2?: string;
+  cb_additionalInformation3?: string;
+  cb_additionalInformation4?: string;
+  cb_merchantName?: string;
+  cb_accountName?: string;
+  cb_endToEndId?: string;
+  cb_iban4u?: string;
+  createdAt?: Date;
+  updatedAt?: Date;
+}
+export interface TransactionFinXPChargeback extends Transaction {
+  bank: typeof BANKS.finXP;
+  id?: number;
+  status?: string;
+  chargebackDate?: string;
+  statementDate?: string;
+  chargebackAmount?: string;
+  initiatedAmount?: string;
+  bankFees?: string;
+  currency?: string;
+  chargebackEntryInformation?: string;
+  paymentAdviceIdentifier?: string;
+  rejectCode?: string;
+  chargebackRemittanceInformation?: string;
+  chargebackReason?: string;
+  paymentAdviceDate?: string;
+  initiatedDate?: string;
+  fileName?: string;
+  sepaProduct?: string;
+  product?: string;
+  customerNumber?: string;
+  customerName?: string;
+  customerBic?: string;
+  customerIban?: string;
+  transactionInformation?: string;
+  invoiceNumber?: string;
+  additionalInformation?: string;
+  additionalInformation2?: string;
+  additionalInformation3?: string;
+  additionalInformation4?: string;
+  merchantName?: string;
+  accountName?: string;
+  endToEndId?: string;
+  iban4u?: string;
+  createdAt?: Date;
+  updatedAt?: Date;
+}
+
+export const finXPCSVToTransactionColumn: Partial<Record<keyof TransactionFinXP, string>> = {
+  status: "STATUS",
+  endToEndId: "END TO END ID",
+  merchant: "MERCHANT",
+  amount: "AMOUNT",
+  effectiveDate: "EFFECTIVE DATE",
+  customerBic: "CUSTOMER BIC",
+  customerIban: "CUSTOMER IBAN",
+  customerName: "CUSTOMER NAME",
+  customerId: "CUSTOMER ID",
+  additionalInfo1: "ADDITIONAL INFO 1",
+  additionalInfo2: "ADDITIONAL INFO 2",
+  importedDate: "IMPORTED DATE",
+  mandateReference: "MANDATE REFERENCE",
+  transactionInformation: "TRANSACTION INFORMATION",
+  transactionTypeName: "TRANSACTION TYPE NAME",
+  errorCode: "ERROR CODE",
+  importedFile: "IMPORTED FILE",
+  merchantProductName: "MERCHANT PRODUCT NAME",
+  bankFee: "BANK FEE",
+  isChargeback: "IS CHARGEBACK",
+  mandateDate: "MANDATE DATE",
+  cb_status: "Status",
+  cb_chargebackDate: "Chargeback date",
+  cb_statementDate: "Statement date",
+  cb_chargebackAmount: "Chargeback amount",
+  cb_initiatedAmount: "Initiated amount",
+  cb_bankFees: "Bank fees",
+  cb_currency: "Currency",
+  cb_chargebackEntryInformation: "Chargeback entry information",
+  cb_paymentAdviceIdentifier: "Payment advice identifier",
+  cb_rejectCode: "Reject code",
+  cb_chargebackRemittanceInformation: "Chargeback remittance information",
+  cb_chargebackReason: "Chargeback reason",
+  cb_paymentAdviceDate: "Payment advice date",
+  cb_initiatedDate: "Initiated date",
+  cb_fileName: "File name",
+  cb_sepaProduct: "SEPA product",
+  cb_product: "Product",
+  cb_customerNumber: "Customer number",
+  cb_customerName: "Customer name",
+  cb_customerBic: "Customer BIC",
+  cb_customerIban: "Customer IBAN",
+  cb_transactionInformation: "Transaction Information",
+  cb_invoiceNumber: "Invoice number",
+  cb_additionalInformation: "Additional Information",
+  cb_additionalInformation2: "Additional Information 2",
+  cb_additionalInformation3: "Additional Information 3",
+  cb_additionalInformation4: "Additional Information 4",
+  cb_merchantName: "Merchant name",
+  cb_accountName: "Account name",
+  cb_endToEndId: "End to end id",
+  cb_iban4u: "Iban4U"
+};
+
+export const finXPCSVToChargebackColumn: Partial<Record<keyof TransactionFinXPChargeback, string>> = {
+  status: "Status",
+  chargebackDate: "Chargeback date",
+  statementDate: "Statement date",
+  chargebackAmount: "Chargeback amount",
+  initiatedAmount: "Initiated amount",
+  bankFees: "Bank fees",
+  currency: "Currency",
+  chargebackEntryInformation: "Chargeback entry information",
+  paymentAdviceIdentifier: "Payment advice identifier",
+  rejectCode: "Reject code",
+  chargebackRemittanceInformation: "Chargeback remittance information",
+  chargebackReason: "Chargeback reason",
+  paymentAdviceDate: "Payment advice date",
+  initiatedDate: "Initiated date",
+  fileName: "File name",
+  sepaProduct: "SEPA product",
+  product: "Product",
+  customerNumber: "Customer number",
+  customerName: "Customer name",
+  customerBic: "Customer BIC",
+  customerIban: "Customer IBAN",
+  transactionInformation: "Transaction Information",
+  invoiceNumber: "Invoice number",
+  additionalInformation: "Additional Information",
+  additionalInformation2: "Additional Information 2",
+  additionalInformation3: "Additional Information 3",
+  additionalInformation4: "Additional Information 4",
+  merchantName: "Merchant name",
+  accountName: "Account name",
+  endToEndId: "End to end id",
+  iban4u: "Iban4U",
+};

package/src/gateways/adapters/model/transactionNovalNet.model.ts

@@ -0,0 +1,224 @@
+import { Transaction } from "../../../model/transaction.model";
+import { BANKS } from "../../../model/gateway.model";
+
+export const NOVALNET_STATUS_DESC = {
+  SUCCESS: 'SUCCESS',
+  PENDING: 'PENDING',
+  FAILED: 'FAILED',
+  CONFIRMED: 'CONFIRMED',
+  CANCELLED: 'CANCELLED',
+  REFUNDED: 'REFUNDED',
+  CHARGEBACK: 'CHARGEBACK',
+  REJECTED: 'REJECTED',
+  DECLINED: 'DECLINED',
+  ON_HOLD: 'ON_HOLD',
+  PROCESSING: 'PROCESSING'
+} as const;
+export type NOVALNET_STATUS_DESC = (typeof NOVALNET_STATUS_DESC)[keyof typeof NOVALNET_STATUS_DESC];
+
+export function isTransactionNovalnet(t: Transaction): t is TransactionNovalNet {
+  return t?.bank === BANKS.Novalnet;
+}
+
+export interface TransactionNovalNet extends Transaction {
+  bank: typeof BANKS.Novalnet;
+  id?: number;
+  date?: string;
+  time?: string;
+  activationDate?: string;
+  activationTime?: string;
+  tid?: string;
+  status?: string;
+  statusDesc?: string;
+  paymentType?: string;
+  invoiceType?: string;
+  invoiceRef?: string;
+  amount?: string;
+  currency?: string;
+  amountEur?: string;
+  cost?: string;
+  tax?: string;
+  costInclTax?: string;
+  fixCommissionAmount?: string;
+  fixCommissionAmountEur?: string;
+  payoutAmount?: string;
+  payoutCurrency?: string;
+  origAmount?: string;
+  origTid?: string;
+  origDate?: string;
+  description?: string;
+  marker?: string;
+  novalcardNumber?: string;
+  customerNumber?: number; //subscriptionId
+  orderNumber?: number; //orderId
+  gender?: string;
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  street?: string;
+  houseNumber?: string;
+  zipCode?: string;
+  city?: string;
+  countryCode?: string;
+  birthdate?: string;
+  company?: string;
+  input1?: string;
+  inputVal1?: string;
+  input2?: string;
+  inputVal2?: string;
+  input3?: string;
+  inputVal3?: string;
+  input4?: string;
+  inputVal4?: string;
+  refundAmount?: string;
+  refundTid?: string;
+  refundDate?: string;
+  refundRef?: string;
+  returnAmount?: string;
+  returnTid?: string;
+  returnDate?: string;
+  returnCode?: string;
+  returnReason?: string;
+  creditAmount?: string;
+  creditTid?: string;
+  creditDate?: string;
+  openAmount?: string;
+  paymentInfo1?: string;
+  paymentInfo2?: string;
+  paymentInfo3?: string;
+  paymentInfo4?: string;
+  subscription?: string;
+  startAmount?: string;
+  startTid?: string;
+  startDate?: string;
+  fraudModules?: string;
+  rejectedFraudModule?: string;
+  projectId?: string;
+  projectName?: string;
+  tariffId?: string;
+  tariffName?: string;
+  affiliateId?: string;
+  affiliateName?: string;
+  merchantId?: string;
+  mobile?: string;
+  countryName?: string;
+  paymentName?: string;
+  streetAndHouseNo?: string;
+  dateAndTime?: string;
+  activationDateAndTime?: string;
+  input5?: string;
+  inputVal5?: string;
+  ipCountry?: string;
+  internetServiceProvider?: string;
+  paymentReference?: string;
+  buergelScore?: string;
+  paymentInfo5?: string;
+  paymentInfo6?: string;
+  subscriptionId?: string | number;
+  vatId?: string;
+  paymentInfo7?: string;
+  accountingReference?: string;
+  novalnetEndcustomerInvoiceNumber?: string;
+}
+
+export const novalNetTransactionColumnMapper: Partial<Record<keyof TransactionNovalNet, string>> = {
+  date: "Date",
+  time: "Time",
+  activationDate: "Activation date",
+  activationTime: "Activation time",
+  tid: "TID",
+  status: "Status",
+  statusDesc: "Status desc",
+  paymentType: "Payment type",
+  invoiceType: "Invoice type",
+  invoiceRef: "Invoice ref",
+  amount: "Amount",
+  currency: "Currency",
+  amountEur: "Amount (EUR)",
+  cost: "Cost",
+  tax: "Tax",
+  costInclTax: "Cost incl. Tax",
+  fixCommissionAmount: "Fix commission amount",
+  fixCommissionAmountEur: "Fix commission amount (EUR)",
+  payoutAmount: "Payout amount",
+  payoutCurrency: "Payout currency",
+  origAmount: "Orig amount",
+  origTid: "Orig TID",
+  origDate: "Orig date",
+  description: "Description",
+  marker: "Marker",
+  novalcardNumber: "Novalcard number",
+  customerNumber: "Customer number",
+  orderNumber: "Order number",
+  gender: "Gender",
+  firstName: "First name",
+  lastName: "Last name",
+  email: "Email",
+  street: "Street",
+  houseNumber: "House number",
+  zipCode: "Zip code",
+  city: "City",
+  countryCode: "Country code",
+  birthdate: "Birthdate",
+  company: "Company",
+  input1: "Input1",
+  inputVal1: "Input val1",
+  input2: "Input2",
+  inputVal2: "Input val2",
+  input3: "Input3",
+  inputVal3: "Input val3",
+  input4: "Input4",
+  inputVal4: "Input val4",
+  refundAmount: "Refund amount",
+  refundTid: "Refund TID",
+  refundDate: "Refund date",
+  refundRef: "Refund ref",
+  returnAmount: "Return amount",
+  returnTid: "Return TID",
+  returnDate: "Return date",
+  returnCode: "Return code",
+  returnReason: "Return reason",
+  creditAmount: "Credit amount",
+  creditTid: "Credit TID",
+  creditDate: "Credit date",
+  openAmount: "Open amount",
+  paymentInfo1: "Payment info1",
+  paymentInfo2: "Payment info2",
+  paymentInfo3: "Payment info3",
+  paymentInfo4: "Payment info4",
+  subscription: "Subscription",
+  startAmount: "Start amount",
+  startTid: "Start TID",
+  startDate: "Start date",
+  fraudModules: "Fraud modules",
+  rejectedFraudModule: "Rejected fraud module",
+  projectId: "Project ID",
+  projectName: "Project name",
+  tariffId: "Tariff ID",
+  tariffName: "Tariff name",
+  affiliateId: "Affiliate ID",
+  affiliateName: "Affiliate name",
+  merchantId: "Merchant ID",
+  mobile: "Mobile",
+  countryName: "Country name",
+  paymentName: "Payment name",
+  streetAndHouseNo: "Street and House no",
+  dateAndTime: "Date and Time",
+  activationDateAndTime: "Activation date and time",
+  input5: "Input5",
+  inputVal5: "Input val5",
+  ipCountry: "IP country",
+  internetServiceProvider: "Internet service provider",
+  paymentReference: "Payment reference",
+  buergelScore: "Bürgel score",
+  paymentInfo5: "Payment info5",
+  paymentInfo6: "Payment info6",
+  subscriptionId: "Subscription ID",
+  vatId: "VAT ID",
+  paymentInfo7: "Payment info7",
+  accountingReference: "Accounting reference",
+  novalnetEndcustomerInvoiceNumber: "Novalnet Endcustomer invoice number"
+};
+
+export const novalNetTransactionColumnKeys = Object.keys(novalNetTransactionColumnMapper);
+export const novalNetTransactionColumnValues = Object.values(novalNetTransactionColumnMapper);

package/src/gateways/providers/model/genesis.constants.ts

@@ -0,0 +1,30 @@
+export const GENESIS_TRANSACTION_TYPE_BY_PAYMENT_METHOD = {
+  SEPA_DD: {
+    SDD_SALE: "sdd_sale",
+    SDD_REFUND: "sdd_refund"
+  },
+  CREDIT_CARD: {
+    SALE: "sale",
+    REFUND: "refund",
+    CHARGEBACK: "chargeback",
+  },
+};
+
+export const GENESIS_TRANSACTION_TYPE = {
+  SDD_SALE: "sdd_sale",
+  SDD_REFUND: "sdd_refund"
+};
+export type GENESIS_TRANSACTION_TYPE = (typeof GENESIS_TRANSACTION_TYPE)[keyof typeof GENESIS_TRANSACTION_TYPE];
+
+export const GENESIS_TRANSACTION_STATUS = {
+  APPROVED: "approved",
+  PENDING_ASYNC: "pending_async",
+  ERROR: "error"
+};
+export type GENESIS_TRANSACTION_STATUS = (typeof GENESIS_TRANSACTION_STATUS)[keyof typeof GENESIS_TRANSACTION_STATUS];
+
+export const GENESIS_TRANSACTION_MODE = {
+  LIVE: "live",
+  TEST: "test"
+};
+export type GENESIS_TRANSACTION_MODE = (typeof GENESIS_TRANSACTION_MODE)[keyof typeof GENESIS_TRANSACTION_MODE];

package/src/gateways/providers/model/genesis.model.ts

@@ -0,0 +1,89 @@
+import { GENESIS_TRANSACTION_TYPE } from "./genesis.constants";
+import { GENESIS_TRANSACTION_STATUS } from "./genesis.constants";
+import { GENESIS_TRANSACTION_MODE } from "./genesis.constants";
+
+export interface GenesisConfig {
+  customer: {
+    username?: string;
+    password?: string;
+    token?: string;
+    force_smart_routing?: boolean;
+  };
+  gateway: {
+    protocol?: string;
+    hostname?: string; //endpoint-you-want e-comprocessing.net or emerchantpay.net
+    timeout?: string;
+    testing: boolean;
+  };
+  notifications?: {
+    host: string;
+    port: string;
+    path: string;
+  };
+}
+
+export interface GenesisSddSaleParams {
+  transaction_id: string; //orderId
+  usage: string;
+  remote_ip: string;
+  amount: string;
+  currency: string;
+  iban: string;
+  bic: string;
+  billing_address: {
+    first_name: string;
+    last_name: string;
+    city: string;
+    address1: string;
+    country: string;
+    zip_code: string;
+  };
+}
+
+export interface GenesisResponse {
+  transaction_type?: GENESIS_TRANSACTION_TYPE;
+  status: GENESIS_TRANSACTION_STATUS;
+  unique_id: string;       //EMP transactionId
+  transaction_id?: string; //orderId. When we download CSV from the bank, this value is present in "Merchant Transaction ID"
+  bank_account_number?: string;
+  bank_identifier_code?: string;
+  technical_message?: string;
+  code?: string;
+  message?: string;
+  mode?: GENESIS_TRANSACTION_MODE,
+  timestamp?: string; //"2025-10-27T14:42:27Z"
+  descriptor?: string;
+  amount?: string;
+  currency?: string;
+  sent_to_acquirer?: boolean;
+}
+
+export interface GenesisRiconcileByDateResponse {
+  page: number
+  per_page: number
+  total_count: number;
+  pages_count: number;
+  payment_response: GenesisResponse[];
+}
+
+export interface GenesisRefundParams {
+  transactionId: string;
+}
+
+export interface GenesisChargebackParams {
+  transactionId: string;
+}
+
+export interface GenesisError {
+  status: string;
+  code?: string;
+  message?: string;
+  technical_message?: string;
+  response?: GenesisFieldError[];
+}
+
+export interface GenesisFieldError {
+  type: string;
+  property: string;
+  message: string;
+}

package/src/gateways/providers/model/novalNetManual.model.ts

@@ -0,0 +1,119 @@
+export interface NovalNetSddSaleParams {
+  vendorId: string;
+  vendorAuthcode: string;
+  productId: string;
+  tariffId: string;
+  testMode: string;
+  amount: string;
+  currency: string;
+  tariffPeriod: string;
+  tariffPeriod2: string;
+  tariffPeriod2Amount: string;
+  utf8: string;
+  lang: string;
+  orderNo: string;
+  customerNo: string;
+  gender: string;
+  title: string;
+  firstName: string;
+  lastName: string;
+  street: string;
+  searchInStreet: string;
+  zip: string;
+  city: string;
+  countryCode: string;
+  birthDate: string;
+  tel: string;
+  mobile: string;
+  email: string;
+  paymentType: string;
+  invoiceType: string;
+  dueDate: string;
+  invoiceRef: string;
+  paymentRef: string;
+  tid: string;
+  sepaDueDate: string;
+  mandatePresent: string;
+  mandateSignatureDate: string;
+  mandateId: string;
+  iban: string;
+  bic: string;
+  debitAccountHolder: string;
+  debitReason1: string;
+  debitReason2: string;
+  debitReason3: string;
+  debitReason4: string;
+  debitReason5: string;
+  input1: string;
+  input2: string;
+  input3: string;
+  input4: string;
+  input5: string;
+  input6: string;
+  input7: string;
+  discount: string;
+  mref: string;
+  createPaymentRef: string;
+  noRc: string;
+}
+
+export const novalNetSDDRequestColumnMapper: Partial<Record<keyof NovalNetSddSaleParams, string>> = {
+  vendorId: "vendor_id",
+  vendorAuthcode: "vendor_authcode",
+  productId: "product_id",
+  tariffId: "tariff_id",
+  testMode: "test_mode",
+  amount: "amount",
+  currency: "currency",
+  tariffPeriod: "tariff_period",
+  tariffPeriod2: "tariff_period2",
+  tariffPeriod2Amount: "tariff_period2_amount",
+  utf8: "utf8",
+  lang: "lang",
+  orderNo: "order_no",
+  customerNo: "customer_no",
+  gender: "gender",
+  title: "title",
+  firstName: "first_name",
+  lastName: "last_name",
+  street: "street",
+  searchInStreet: "search_in_street",
+  zip: "zip",
+  city: "city",
+  countryCode: "country_code",
+  birthDate: "birth_date",
+  tel: "tel",
+  mobile: "mobile",
+  email: "email",
+  paymentType: "payment_type",
+  invoiceType: "invoice_type",
+  dueDate: "due_date",
+  invoiceRef: "invoice_ref",
+  paymentRef: "payment_ref",
+  tid: "tid",
+  sepaDueDate: "sepa_due_date",
+  mandatePresent: "mandate_present",
+  mandateSignatureDate: "mandate_signature_date",
+  mandateId: "mandate_id",
+  iban: "iban",
+  bic: "bic",
+  debitAccountHolder: "debit_account_holder",
+  debitReason1: "debit_reason_1",
+  debitReason2: "debit_reason_2",
+  debitReason3: "debit_reason_3",
+  debitReason4: "debit_reason_4",
+  debitReason5: "debit_reason_5",
+  input1: "input1",
+  input2: "input2",
+  input3: "input3",
+  input4: "input4",
+  input5: "input5",
+  input6: "input6",
+  input7: "input7",
+  discount: "discount",
+  mref: "mref",
+  createPaymentRef: "create_payment_ref",
+  noRc: "no_rc",
+};
+export const novalNetSDDRequestColumnMapperKeys = Object.keys(novalNetSDDRequestColumnMapper);
+export const novalNetSDDRequestColumnMapperValues = Object.values(novalNetSDDRequestColumnMapper);