resurgence-data 1.1.20 → 1.1.22

package/dist/functions/id-generation/index.d.ts

@@ -0,0 +1 @@
+export declare function generateUUID(): string;

package/dist/functions/id-generation/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUUID = generateUUID;
+const uuid_1 = require("uuid");
+function generateUUID() {
+    return (0, uuid_1.v4)();
+}

package/dist/functions/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./id-generation";
+export * from "./manipulation";

package/dist/functions/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./id-generation"), exports);
+__exportStar(require("./manipulation"), exports);

package/dist/functions/manipulation/index.d.ts

@@ -0,0 +1,4 @@
+export declare function toCamel(s: any): any;
+export declare function isArray(a: any): a is any[];
+export declare function isObject(o: any): boolean;
+export declare function keysToCamelCase(o: any): any;

package/dist/functions/manipulation/index.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toCamel = toCamel;
+exports.isArray = isArray;
+exports.isObject = isObject;
+exports.keysToCamelCase = keysToCamelCase;
+function toCamel(s) {
+    return s.replace(/([-_][a-z])/gi, ($1) => {
+        return $1.toUpperCase().replace("-", "").replace("_", "");
+    });
+}
+function isArray(a) {
+    return Array.isArray(a);
+}
+function isObject(o) {
+    return o === Object(o) && !isArray(o) && typeof o !== "function";
+}
+function keysToCamelCase(o) {
+    if (isObject(o)) {
+        const n = {};
+        Object.keys(o).forEach((k) => {
+            n[toCamel(k)] = keysToCamelCase(o[k]);
+        });
+        return n;
+    }
+    else if (isArray(o)) {
+        return o.map((i) => {
+            return keysToCamelCase(i);
+        });
+    }
+    return o;
+}

package/dist/index.d.ts

@@ -6,3 +6,5 @@ export * from "./messaging";
 export * from "./biller";
 export * from "./payment";
 export * from "./invoice";
+export * from "./integration";
+export * from "./functions";

package/dist/index.js

@@ -22,3 +22,5 @@ __exportStar(require("./messaging"), exports);
 __exportStar(require("./biller"), exports);
 __exportStar(require("./payment"), exports);
 __exportStar(require("./invoice"), exports);
+__exportStar(require("./integration"), exports);
+__exportStar(require("./functions"), exports);

package/dist/integration/flutterwave/index.d.ts

@@ -0,0 +1 @@
+export * from "./payloads";

package/dist/integration/flutterwave/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./payloads"), exports);

package/dist/integration/flutterwave/payloads.d.ts

@@ -0,0 +1,165 @@
+export interface FlutterwavePinAuthorizationDTO {
+    mode: string;
+    pin: string;
+}
+export interface FlutterwaveCardAVSAuthorizationDTO {
+    mode: string;
+    city: string;
+    address: string;
+    state: string;
+    country: string;
+    zipcode: string;
+}
+export interface FlutterwaveCardChargeResponseDTO {
+    status: string;
+    message: string;
+    data: {
+        id: number;
+        tx_ref: string;
+        flw_ref: string;
+        device_fingerprint: string;
+        amount: number;
+        charged_amount: number;
+        app_fee: number;
+        merchant_fee: number;
+        processor_response: string;
+        auth_model: string;
+        currency: string;
+        ip: string;
+        narration: string;
+        status: string;
+        auth_url: string;
+        payment_type: string;
+        fraud_status: string;
+        charge_type: string;
+        created_at: string;
+        account_id: number;
+        customer: {
+            id: number;
+            phone_number: string;
+            name: string;
+            email: string;
+            created_at: string;
+        };
+        card: {
+            first_6digits: string;
+            last_4digits: string;
+            issuer: string;
+            country: string;
+            type: string;
+            expiry: string;
+        };
+    };
+    meta: {
+        authorization: {
+            mode: string;
+            fields?: string[];
+            endpoint?: string;
+            redirect?: string;
+        };
+    };
+}
+export interface FlutterwaveCardChargePayload {
+    cardNumber: string;
+    expiryMonth: string;
+    expiryYear: string;
+    cvv: string;
+    currency: string;
+    amount: number;
+    emailAddress: string;
+    fullname: string;
+    phoneNumber: string;
+    txRef: string;
+    redirectUrl: string;
+    enckey: string;
+    authorization: FlutterwavePinAuthorizationDTO | FlutterwaveCardAVSAuthorizationDTO;
+}
+export interface Flutterwave3DSChargeResponseDTO {
+    id: number;
+    tx_ref: string;
+    flw_ref: string;
+    device_fingerprint: string;
+    amount: number;
+    charged_amount: number;
+    app_fee: number;
+    merchant_fee: number;
+    processor_response: string;
+    auth_model: string;
+    currency: string;
+    ip: string;
+    narration: string;
+    status: string;
+    payment_type: string;
+    fraud_status: string;
+    charge_type: string;
+    created_at: string;
+    account_id: number;
+    customer: {
+        id: number;
+        phone_number: string;
+        name: string;
+        email: string;
+        created_at: string;
+    };
+    card: {
+        first_6digits: string;
+        last_4digits: string;
+        issuer: string;
+        country: string;
+        type: string;
+        expiry: string;
+    };
+}
+export interface FlutterwaveCardResponseDTO {
+    status: string;
+    message: string;
+    data?: Flutterwave3DSChargeResponseDTO;
+    meta: {
+        authorization: {
+            mode: string;
+            fields?: string[];
+            endpoint?: string;
+            redirect?: string;
+        };
+    };
+}
+export interface VerifyPaymentResponseDTO {
+    status: string;
+    message: string;
+    data: {
+        id: number;
+        tx_ref: string;
+        flw_ref: string;
+        device_fingerprint: string;
+        amount: number;
+        currency: string;
+        charged_amount: number;
+        app_fee: number;
+        merchant_fee: number;
+        processor_response: string;
+        auth_model: string;
+        ip: string;
+        narration: string;
+        status: string;
+        payment_type: string;
+        created_at: string;
+        account_id: number;
+        card: {
+            first_6digits: string;
+            last_4digits: string;
+            issuer: string;
+            country: string;
+            type: string;
+            token: string;
+            expiry: string;
+        };
+        amount_settled: number;
+        customer: {
+            id: number;
+            phone_number: string;
+            name: string;
+            email: string;
+            created_at: string;
+        };
+    };
+}

package/dist/integration/flutterwave/payloads.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var FlutterwaveCardAuthorizationType;
+(function (FlutterwaveCardAuthorizationType) {
+    FlutterwaveCardAuthorizationType["PIN"] = "pin";
+    FlutterwaveCardAuthorizationType["OTP"] = "otp";
+    FlutterwaveCardAuthorizationType["AVS"] = "avs_noauth";
+    FlutterwaveCardAuthorizationType["REDIRECT"] = "redirect";
+})(FlutterwaveCardAuthorizationType || (FlutterwaveCardAuthorizationType = {}));

package/dist/integration/index.d.ts

@@ -0,0 +1 @@
+export * from "./flutterwave";

package/dist/integration/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./flutterwave"), exports);

package/dist/payment/payment-request/payment-request.dto.d.ts

@@ -6,6 +6,7 @@ export declare class TransactionSplitDto {
     splitAmount?: number;
 }
 export declare class PaymentRequestDto {
+    uniqueTransactionRef?: string;
     billerId: string;
     apiKey?: string;
     customerId?: string;
@@ -13,7 +14,7 @@ export declare class PaymentRequestDto {
     paymentPageId?: string;
     transactionTotal: number;
     requestChannel: string;
-    processorId: string;
+    processorId?: string;
     ipAddress?: string;
     requestUrl?: string;
     redirectUrl?: string;
@@ -23,6 +24,7 @@ export declare class PaymentRequestDto {
     transactionSplits?: TransactionSplitDto[];
 }
 export declare class APIPaymentRequestDto {
+    uniqueTransactionRef?: string;
     billerId?: string;
     apiKey?: string;
     customerId?: string;
@@ -37,3 +39,14 @@ export declare class APIPaymentRequestDto {
     customerPhoneNumber?: string;
     transactionSplits?: TransactionSplitDto[];
 }
+export declare class cardChargeDTO {
+    currency: string;
+    cardNumber: string;
+    cvv: string;
+    expiryMonth: string;
+    expiryYear: string;
+    emailAddress: string;
+    transactionReference: string;
+    cardHolderName?: string;
+    redirectUrl?: string;
+}

package/dist/payment/payment-request/payment-request.dto.js

@@ -18,7 +18,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.APIPaymentRequestDto = exports.PaymentRequestDto = exports.TransactionSplitDto = void 0;
+exports.cardChargeDTO = exports.APIPaymentRequestDto = exports.PaymentRequestDto = exports.TransactionSplitDto = void 0;
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const class_validator_2 = require("class-validator");
@@ -57,6 +57,11 @@ __decorate([
 class PaymentRequestDto {
 }
 exports.PaymentRequestDto = PaymentRequestDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Unique identifier for the transaction from the biller" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Your unique transaction reference is required" }),
+    __metadata("design:type", String)
+], PaymentRequestDto.prototype, "uniqueTransactionRef", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ description: "Unique identifier for the biller" }),
     (0, class_validator_2.IsUUID)("4", { message: "Biller ID must be a valid UUID" }),
@@ -102,7 +107,7 @@ __decorate([
 __decorate([
     (0, swagger_1.ApiProperty)({ description: "Unique identifier for the processor" }),
     (0, class_validator_2.IsUUID)("4", { message: "Processor ID must be a valid UUID" }),
-    (0, class_validator_1.IsNotEmpty)({ message: "Processor ID is required" }),
+    (0, class_validator_2.IsOptional)(),
     __metadata("design:type", String)
 ], PaymentRequestDto.prototype, "processorId", void 0);
 __decorate([
@@ -149,6 +154,11 @@ __decorate([
 class APIPaymentRequestDto {
 }
 exports.APIPaymentRequestDto = APIPaymentRequestDto;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Unique identifier for the transaction from the biller" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Your unique transaction reference is required" }),
+    __metadata("design:type", String)
+], APIPaymentRequestDto.prototype, "uniqueTransactionRef", void 0);
 __decorate([
     (0, swagger_1.ApiProperty)({ description: "Unique identifier for the biller" }),
     (0, class_validator_2.IsUUID)("4", { message: "Biller ID must be a valid UUID" }),
@@ -226,3 +236,59 @@ __decorate([
     (0, class_validator_2.IsOptional)(),
     __metadata("design:type", Array)
 ], APIPaymentRequestDto.prototype, "transactionSplits", void 0);
+class cardChargeDTO {
+}
+exports.cardChargeDTO = cardChargeDTO;
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Charge currency" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Please check your currency" }),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "currency", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Card number" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Seems you need to check the card number" }),
+    (0, class_validator_1.IsNumberString)(),
+    (0, class_validator_1.MinLength)(8, { message: "Please check you card number" }),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "cardNumber", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Charge CVV" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "You must provide a security code" }),
+    (0, class_validator_1.IsNumberString)(),
+    (0, class_validator_1.Length)(3, 3, { message: "Please check your security code" }),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "cvv", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Card Expiry month" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Check your card expiry month" }),
+    (0, class_validator_1.IsNumberString)(),
+    (0, class_validator_1.Length)(2, 2, { message: "Expiry month must be 2 digits" }),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "expiryMonth", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Card Expiry year" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Check your card expiry year" }),
+    (0, class_validator_1.IsNumberString)(),
+    (0, class_validator_1.Length)(2, 2, { message: "Expiry year must be 2 digits" }),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "expiryYear", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Email address for the customer" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Customer email address is required" }),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "emailAddress", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Transaction reference" }),
+    (0, class_validator_1.IsNotEmpty)({ message: "Transaction reference is required" }),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "transactionReference", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "Card holders full name" }),
+    (0, class_validator_2.IsOptional)(),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "cardHolderName", void 0);
+__decorate([
+    (0, swagger_1.ApiProperty)({ description: "3D Secure redirect url for customer" }),
+    (0, class_validator_2.IsOptional)(),
+    __metadata("design:type", String)
+], cardChargeDTO.prototype, "redirectUrl", void 0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "resurgence-data",
-  "version": "1.1.20",
+  "version": "1.1.22",
   "description": "DTOs and shareable resources",
   "module": "dist/index.js",
   "main": "dist/index.js",
@@ -28,6 +28,7 @@
     "@types/jest": "^29.5.14",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
-    "ts-jest": "^29.2.5"
+    "ts-jest": "^29.2.5",
+    "uuid": "^11.0.5"
   }
 }

package/src/functions/id-generation/index.ts

@@ -0,0 +1,5 @@
+import { v4 as uuidv4 } from "uuid";
+
+export function generateUUID(): string {
+  return uuidv4();
+}

package/src/functions/index.ts

@@ -0,0 +1,2 @@
+export * from "./id-generation";
+export * from "./manipulation";

package/src/functions/manipulation/index.ts

@@ -0,0 +1,31 @@
+export function toCamel(s: any) {
+  return s.replace(/([-_][a-z])/gi, ($1: any) => {
+    return $1.toUpperCase().replace("-", "").replace("_", "");
+  });
+}
+
+export function isArray(a: any) {
+  return Array.isArray(a);
+}
+
+export function isObject(o: any) {
+  return o === Object(o) && !isArray(o) && typeof o !== "function";
+}
+
+export function keysToCamelCase(o: any): any {
+  if (isObject(o)) {
+    const n: any = {};
+
+    Object.keys(o).forEach((k) => {
+      n[toCamel(k)] = keysToCamelCase(o[k]);
+    });
+
+    return n;
+  } else if (isArray(o)) {
+    return o.map((i: any) => {
+      return keysToCamelCase(i);
+    });
+  }
+
+  return o;
+}

package/src/index.ts

@@ -6,3 +6,5 @@ export * from "./messaging";
 export * from "./biller";
 export * from "./payment";
 export * from "./invoice";
+export * from "./integration";
+export * from "./functions";

package/src/integration/flutterwave/index.ts

@@ -0,0 +1 @@
+export * from "./payloads";

package/src/integration/flutterwave/payloads.ts

@@ -0,0 +1,178 @@
+export interface FlutterwavePinAuthorizationDTO {
+  mode: string;
+  pin: string;
+}
+
+export interface FlutterwaveCardAVSAuthorizationDTO {
+  mode: string;
+  city: string;
+  address: string;
+  state: string;
+  country: string;
+  zipcode: string;
+}
+
+export interface FlutterwaveCardChargeResponseDTO {
+  status: string;
+  message: string;
+  data: {
+    id: number;
+    tx_ref: string;
+    flw_ref: string;
+    device_fingerprint: string;
+    amount: number;
+    charged_amount: number;
+    app_fee: number;
+    merchant_fee: number;
+    processor_response: string;
+    auth_model: string;
+    currency: string;
+    ip: string;
+    narration: string;
+    status: string;
+    auth_url: string;
+    payment_type: string;
+    fraud_status: string;
+    charge_type: string;
+    created_at: string;
+    account_id: number;
+    customer: {
+      id: number;
+      phone_number: string;
+      name: string;
+      email: string;
+      created_at: string;
+    };
+    card: {
+      first_6digits: string;
+      last_4digits: string;
+      issuer: string;
+      country: string;
+      type: string;
+      expiry: string;
+    };
+  };
+  meta: {
+    authorization: {
+      mode: string;
+      fields?: string[]; // required for avs and pin auth
+      endpoint?: string; // required for otp validation
+      redirect?: string; // required for 3DS redirect
+    };
+  };
+}
+
+export interface FlutterwaveCardChargePayload {
+  cardNumber: string;
+  expiryMonth: string;
+  expiryYear: string;
+  cvv: string;
+  currency: string;
+  amount: number;
+  emailAddress: string;
+  fullname: string;
+  phoneNumber: string;
+  txRef: string;
+  redirectUrl: string;
+  enckey: string;
+  authorization: FlutterwavePinAuthorizationDTO | FlutterwaveCardAVSAuthorizationDTO;
+}
+
+export interface Flutterwave3DSChargeResponseDTO {
+  id: number;
+  tx_ref: string;
+  flw_ref: string;
+  device_fingerprint: string;
+  amount: number;
+  charged_amount: number;
+  app_fee: number;
+  merchant_fee: number;
+  processor_response: string;
+  auth_model: string;
+  currency: string;
+  ip: string;
+  narration: string;
+  status: string;
+  payment_type: string;
+  fraud_status: string;
+  charge_type: string;
+  created_at: string;
+  account_id: number;
+  customer: {
+    id: number;
+    phone_number: string;
+    name: string;
+    email: string;
+    created_at: string;
+  };
+  card: {
+    first_6digits: string;
+    last_4digits: string;
+    issuer: string;
+    country: string;
+    type: string;
+    expiry: string;
+  };
+}
+
+enum FlutterwaveCardAuthorizationType {
+  PIN = "pin",
+  OTP = "otp",
+  AVS = "avs_noauth",
+  REDIRECT = "redirect", //3ds
+}
+
+export interface FlutterwaveCardResponseDTO {
+  status: string;
+  message: string;
+  data?: Flutterwave3DSChargeResponseDTO;
+  meta: {
+    authorization: {
+      mode: string;
+      fields?: string[]; //required for avs and pin auth
+      endpoint?: string; //required for otp validation
+      redirect?: string; //required for 3DS redirect
+    };
+  };
+}
+
+export interface VerifyPaymentResponseDTO {
+  status: string;
+  message: string;
+  data: {
+    id: number;
+    tx_ref: string;
+    flw_ref: string;
+    device_fingerprint: string;
+    amount: number;
+    currency: string;
+    charged_amount: number;
+    app_fee: number;
+    merchant_fee: number;
+    processor_response: string;
+    auth_model: string;
+    ip: string;
+    narration: string;
+    status: string;
+    payment_type: string;
+    created_at: string;
+    account_id: number;
+    card: {
+      first_6digits: string;
+      last_4digits: string;
+      issuer: string;
+      country: string;
+      type: string;
+      token: string;
+      expiry: string;
+    };
+    amount_settled: number;
+    customer: {
+      id: number;
+      phone_number: string;
+      name: string;
+      email: string;
+      created_at: string;
+    };
+  };
+}

package/src/integration/index.ts

@@ -0,0 +1 @@
+export * from "./flutterwave";

package/src/payment/payment-request/payment-request.dto.ts

@@ -9,7 +9,17 @@
 // * @apiParam {Object} [splitDetails] Transaction split details.
 
 import { ApiProperty } from "@nestjs/swagger";
-import { IsIn, IsInt, IsNotEmpty, IsNumber, IsString } from "class-validator";
+import {
+  IsIn,
+  IsInt,
+  IsNotEmpty,
+  IsNumber,
+  isNumberString,
+  IsNumberString,
+  IsString,
+  Length,
+  MinLength,
+} from "class-validator";
 import { IsOptional, IsUUID, IsEnum, IsIP, IsUrl, IsEmail } from "class-validator";
 
 export class TransactionSplitDto {
@@ -38,6 +48,10 @@ export class TransactionSplitDto {
   splitAmount?: number;
 }
 export class PaymentRequestDto {
+  @ApiProperty({ description: "Unique identifier for the transaction from the biller" })
+  @IsNotEmpty({ message: "Your unique transaction reference is required" })
+  uniqueTransactionRef?: string;
+
   @ApiProperty({ description: "Unique identifier for the biller" })
   @IsUUID("4", { message: "Biller ID must be a valid UUID" })
   @IsNotEmpty({ message: "Biller ID is required" })
@@ -75,8 +89,8 @@ export class PaymentRequestDto {
 
   @ApiProperty({ description: "Unique identifier for the processor" })
   @IsUUID("4", { message: "Processor ID must be a valid UUID" })
-  @IsNotEmpty({ message: "Processor ID is required" })
-  processorId: string;
+  @IsOptional()
+  processorId?: string;
 
   @ApiProperty({ description: "IP address of the customer", required: false })
   @IsOptional()
@@ -114,6 +128,10 @@ export class PaymentRequestDto {
 }
 
 export class APIPaymentRequestDto {
+  @ApiProperty({ description: "Unique identifier for the transaction from the biller" })
+  @IsNotEmpty({ message: "Your unique transaction reference is required" })
+  uniqueTransactionRef?: string;
+
   @ApiProperty({ description: "Unique identifier for the biller" })
   @IsUUID("4", { message: "Biller ID must be a valid UUID" })
   @IsOptional()
@@ -178,3 +196,41 @@ export class APIPaymentRequestDto {
   @IsOptional()
   transactionSplits?: TransactionSplitDto[];
 }
+
+export class cardChargeDTO {
+  @ApiProperty({ description: "Charge currency" })
+  @IsNotEmpty({ message: "Please check your currency" })
+  currency: string;
+  @ApiProperty({ description: "Card number" })
+  @IsNotEmpty({ message: "Seems you need to check the card number" })
+  @IsNumberString()
+  @MinLength(8, { message: "Please check you card number" })
+  cardNumber: string;
+  @ApiProperty({ description: "Charge CVV" })
+  @IsNotEmpty({ message: "You must provide a security code" })
+  @IsNumberString()
+  @Length(3, 3, { message: "Please check your security code" })
+  cvv: string;
+  @ApiProperty({ description: "Card Expiry month" })
+  @IsNotEmpty({ message: "Check your card expiry month" })
+  @IsNumberString()
+  @Length(2, 2, { message: "Expiry month must be 2 digits" })
+  expiryMonth: string;
+  @ApiProperty({ description: "Card Expiry year" })
+  @IsNotEmpty({ message: "Check your card expiry year" })
+  @IsNumberString()
+  @Length(2, 2, { message: "Expiry year must be 2 digits" })
+  expiryYear: string;
+  @ApiProperty({ description: "Email address for the customer" })
+  @IsNotEmpty({ message: "Customer email address is required" })
+  emailAddress: string;
+  @ApiProperty({ description: "Transaction reference" })
+  @IsNotEmpty({ message: "Transaction reference is required" })
+  transactionReference: string;
+  @ApiProperty({ description: "Card holders full name" })
+  @IsOptional()
+  cardHolderName?: string;
+  @ApiProperty({ description: "3D Secure redirect url for customer" })
+  @IsOptional()
+  redirectUrl?: string;
+}