prospay-sdk 1.0.0

package/dist/invoice/invoice.service.d.ts

@@ -0,0 +1,76 @@
+import { HttpService } from '@nestjs/axios';
+export interface GenerateBulkInvoiceDto {
+    templateName: string;
+    productId: string;
+    startDate: string;
+    endDate: string;
+    buyer_customerId: string;
+    seller_customerId: string;
+    due_date: string;
+    invoice_no: string;
+    invoice_date: string;
+    invoice_period: string;
+}
+export interface ProspayGenerateInvoiceResponse {
+    status: string;
+    message: string;
+    refId: string;
+}
+export interface BulkInvoiceItem {
+    endDate: string;
+    startDate: string;
+    buyer_customerId: string;
+    seller_customerId: string;
+    productId: string;
+    due_date: string;
+    invoice_no: string;
+    invoice_date: string;
+    invoice_period: string;
+}
+export interface GenerateBulkInvoiceBatchDto {
+    templateName: string;
+    data: BulkInvoiceItem[];
+}
+export interface GenerateInvoiceDto {
+    templateName: string;
+    productId: string;
+    startDate: string;
+    endDate: string;
+    buyer_customerId: string;
+    seller_customerId: string;
+    due_date: string;
+    invoice_no: string;
+    invoice_date: string;
+    invoice_period: string;
+}
+export interface InvoiceStatusStatistics {
+    total: number;
+    success: number;
+    failed: number;
+    processing: number;
+}
+export interface InvoiceStatusItem {
+    invoiceId: string | null;
+    status: string;
+    createdAt: string;
+    customerId: string;
+    pdfUrl?: string;
+    completedAt?: string;
+    error?: string;
+    errorDetails?: any;
+}
+export interface ProspayInvoiceStatusResponse {
+    refId: string;
+    overallStatus: string;
+    templateName: string | null;
+    productId: string;
+    statistics: InvoiceStatusStatistics;
+    invoices: InvoiceStatusItem[];
+}
+export declare class ProspayInvoiceService {
+    private readonly http;
+    constructor(http: HttpService);
+    generateBulkInvoice(authToken: string, payload: GenerateBulkInvoiceDto, callbackUrl?: string): Promise<ProspayGenerateInvoiceResponse>;
+    generateInvoice(authToken: string, payload: GenerateInvoiceDto, callbackUrl?: string): Promise<ProspayGenerateInvoiceResponse>;
+    getInvoiceStatus(authToken: string, refId: string): Promise<ProspayInvoiceStatusResponse>;
+}

package/dist/invoice/invoice.service.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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.ProspayInvoiceService = void 0;
+const common_1 = require("@nestjs/common");
+const axios_1 = require("@nestjs/axios");
+const rxjs_1 = require("rxjs");
+let ProspayInvoiceService = class ProspayInvoiceService {
+    constructor(http) {
+        this.http = http;
+    }
+    async generateBulkInvoice(authToken, payload, callbackUrl) {
+        const response$ = this.http.post('/invoices/api/v2.0/generateBulkInvoice', payload, {
+            headers: {
+                Authorization: authToken,
+                'Content-Type': 'application/json',
+                ...(callbackUrl ? { 'callback-url': callbackUrl } : {}),
+            },
+        });
+        const response = await (0, rxjs_1.lastValueFrom)(response$);
+        return response.data;
+    }
+    async generateInvoice(authToken, payload, callbackUrl) {
+        const response$ = this.http.post('/invoices/api/v2.0/generateInvoice', payload, {
+            headers: {
+                Authorization: authToken,
+                'Content-Type': 'application/json',
+                ...(callbackUrl ? { 'callback-url': callbackUrl } : {}),
+            },
+        });
+        const response = await (0, rxjs_1.lastValueFrom)(response$);
+        return response.data;
+    }
+    async getInvoiceStatus(authToken, refId) {
+        const response$ = this.http.get(`/invoices/api/v2.0/invoice-status/${refId}`, {
+            headers: {
+                Authorization: authToken,
+                'Content-Type': 'application/json',
+            },
+        });
+        const response = await (0, rxjs_1.lastValueFrom)(response$);
+        return response.data;
+    }
+};
+exports.ProspayInvoiceService = ProspayInvoiceService;
+exports.ProspayInvoiceService = ProspayInvoiceService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [axios_1.HttpService])
+], ProspayInvoiceService);
+//# sourceMappingURL=invoice.service.js.map

package/dist/invoice/invoice.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.service.js","sourceRoot":"","sources":["../../src/invoice/invoice.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,yCAA4C;AAC5C,+BAAqC;AA+E9B,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAA6B,IAAiB;QAAjB,SAAI,GAAJ,IAAI,CAAa;IAAG,CAAC;IAOlD,KAAK,CAAC,mBAAmB,CACvB,SAAiB,EACjB,OAA+B,EAC/B,WAAoB;QAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAC9B,wCAAwC,EACxC,OAAO,EACP;YACE,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS;gBACxB,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD;SACF,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAOD,KAAK,CAAC,eAAe,CACnB,SAAiB,EACjB,OAA2B,EAC3B,WAAoB;QAEpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAC9B,oCAAoC,EACpC,OAAO,EACP;YACE,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS;gBACxB,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD;SACF,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAOD,KAAK,CAAC,gBAAgB,CACpB,SAAiB,EACjB,KAAa;QAEb,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,qCAAqC,KAAK,EAAE,EAC5C;YACE,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS;gBACxB,cAAc,EAAE,kBAAkB;aACnC;SACF,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF,CAAA;AA7EY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAEwB,mBAAW;GADnC,qBAAqB,CA6EjC"}

package/dist/sdk.config.d.ts

@@ -0,0 +1,6 @@
+export declare const PROSPAY_SDK_OPTIONS = "PROSPAY_SDK_OPTIONS";
+export interface ProspaySdkOptions {
+    productId: string;
+    productApiKey: string;
+    baseUrl?: string;
+}

package/dist/sdk.config.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROSPAY_SDK_OPTIONS = void 0;
+exports.PROSPAY_SDK_OPTIONS = 'PROSPAY_SDK_OPTIONS';
+//# sourceMappingURL=sdk.config.js.map

package/dist/sdk.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.config.js","sourceRoot":"","sources":["../src/sdk.config.ts"],"names":[],"mappings":";;;AAAa,QAAA,mBAAmB,GAAG,qBAAqB,CAAC"}

package/dist/transaction/transaction.service.d.ts

@@ -0,0 +1,145 @@
+import { HttpService } from '@nestjs/axios';
+export interface TransactionChargeBreakup {
+    head: string;
+    amount: number;
+    appliedOn: string[];
+    tags: string[];
+}
+export interface TransactionChargeMetadata {
+    key: string;
+    value: string;
+}
+export interface TransactionCharge {
+    head: string;
+    amount: number;
+    hsnOrSac: string;
+    isBillable: boolean;
+    absorbedBy: string;
+    transactionType: string;
+    chargedAt?: string;
+    breakup?: TransactionChargeBreakup[];
+    metadata?: TransactionChargeMetadata[];
+}
+export interface CreateTransactionDto {
+    customerId: string;
+    entityType: string;
+    referenceId: string;
+    currency: string;
+    vertical: string;
+    charges: TransactionCharge[];
+}
+export interface AddChargesToTransactionDto {
+    charges: TransactionCharge[];
+}
+export interface TransactionDateRangeFilter {
+    start: string;
+    end: string;
+}
+export interface TransactionSearchFilters {
+    customerIds?: string[];
+    transactionDateRange?: TransactionDateRangeFilter;
+}
+export interface SearchTransactionsDto {
+    page: number;
+    limit: number;
+    transactionFilters: TransactionSearchFilters;
+}
+export interface ChargeSummaryParams {
+    startDate: string;
+    endDate: string;
+}
+export interface ProspayCreateTransactionSuccessResponse {
+    success: true;
+    requestId: string;
+    path: string;
+    timestamp: string;
+    data: {
+        transactionId: string;
+        summary: {
+            transactionAmount: number;
+            billableAmount: number;
+            totalCreditAmount: number;
+            totalDebitAmount: number;
+        };
+    };
+}
+export interface ProspayCreateTransactionErrorResponse {
+    success: false;
+    requestId: string;
+    path: string;
+    timestamp: string;
+    error: {
+        code: string;
+        errors: {
+            message: string;
+            field: string;
+            value: string;
+        }[];
+    };
+}
+export interface ProspayAddChargesSuccessResponse {
+    success: true;
+    requestId: string;
+    path: string;
+    timestamp: string;
+    data: {
+        transactionId: string;
+        addedChargesSummary: {
+            transactionAmount: number;
+            billableAmount: number;
+            totalCreditAmount: number;
+            totalDebitAmount: number;
+        };
+        transactionSummary: {
+            transactionAmount: number;
+            billableAmount: number;
+            totalCreditAmount: number;
+            totalDebitAmount: number;
+        };
+    };
+}
+export interface ProspaySearchTransactionsResponse {
+    success: true;
+    requestId: string;
+    path: string;
+    timestamp: string;
+    data: {
+        items: any[];
+        pagination: {
+            total: number;
+            page: number;
+            limit: number;
+            totalPages: number;
+        };
+    };
+}
+export interface ProspayChargeSummaryItem {
+    chargeHead: string;
+    hsnOrSac: string;
+    vertical: string;
+    taxableAmount: number;
+    cgstRate: number;
+    cgst: number;
+    sgstRate: number;
+    sgst: number;
+    igstRate: number;
+    igst: number;
+    totalTaxRate: number;
+    totalTax: number;
+    netAmount: number;
+}
+export interface ProspayChargeSummaryResponse {
+    success: true;
+    requestId: string;
+    path: string;
+    timestamp: string;
+    data: ProspayChargeSummaryItem[];
+}
+export declare class ProspayTransactionService {
+    private readonly http;
+    constructor(http: HttpService);
+    createTransaction(authToken: string, payload: CreateTransactionDto): Promise<ProspayCreateTransactionSuccessResponse>;
+    addChargesToTransaction(authToken: string, transactionId: string, payload: AddChargesToTransactionDto): Promise<ProspayAddChargesSuccessResponse>;
+    searchTransactions(authToken: string, payload: SearchTransactionsDto): Promise<ProspaySearchTransactionsResponse>;
+    getChargeSummary(authToken: string, params: ChargeSummaryParams): Promise<ProspayChargeSummaryResponse>;
+}

package/dist/transaction/transaction.service.js

@@ -0,0 +1,66 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+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.ProspayTransactionService = void 0;
+const common_1 = require("@nestjs/common");
+const axios_1 = require("@nestjs/axios");
+const rxjs_1 = require("rxjs");
+let ProspayTransactionService = class ProspayTransactionService {
+    constructor(http) {
+        this.http = http;
+    }
+    async createTransaction(authToken, payload) {
+        const response$ = this.http.post('/uts/api/transactions', payload, {
+            headers: {
+                Authorization: authToken,
+                'Content-Type': 'application/json',
+            },
+        });
+        const response = await (0, rxjs_1.lastValueFrom)(response$);
+        return response.data;
+    }
+    async addChargesToTransaction(authToken, transactionId, payload) {
+        const response$ = this.http.post(`/uts/api/transactions/${transactionId}/charges`, payload, {
+            headers: {
+                Authorization: authToken,
+                'Content-Type': 'application/json',
+            },
+        });
+        const response = await (0, rxjs_1.lastValueFrom)(response$);
+        return response.data;
+    }
+    async searchTransactions(authToken, payload) {
+        const response$ = this.http.post('/uts/api/transactions/search', payload, {
+            headers: {
+                Authorization: authToken,
+                'Content-Type': 'application/json',
+            },
+        });
+        const response = await (0, rxjs_1.lastValueFrom)(response$);
+        return response.data;
+    }
+    async getChargeSummary(authToken, params) {
+        const response$ = this.http.get('/uts/api/transactions/charge-summary/', {
+            params,
+            headers: {
+                Authorization: authToken,
+            },
+        });
+        const response = await (0, rxjs_1.lastValueFrom)(response$);
+        return response.data;
+    }
+};
+exports.ProspayTransactionService = ProspayTransactionService;
+exports.ProspayTransactionService = ProspayTransactionService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [axios_1.HttpService])
+], ProspayTransactionService);
+//# sourceMappingURL=transaction.service.js.map

package/dist/transaction/transaction.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.service.js","sourceRoot":"","sources":["../../src/transaction/transaction.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,yCAA4C;AAC5C,+BAAqC;AA8J9B,IAAM,yBAAyB,GAA/B,MAAM,yBAAyB;IACpC,YAA6B,IAAiB;QAAjB,SAAI,GAAJ,IAAI,CAAa;IAAG,CAAC;IAOlD,KAAK,CAAC,iBAAiB,CACrB,SAAiB,EACjB,OAA6B;QAE7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAC9B,uBAAuB,EACvB,OAAO,EACP;YACE,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS;gBACxB,cAAc,EAAE,kBAAkB;aACnC;SACF,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAOD,KAAK,CAAC,uBAAuB,CAC3B,SAAiB,EACjB,aAAqB,EACrB,OAAmC;QAEnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAC9B,yBAAyB,aAAa,UAAU,EAChD,OAAO,EACP;YACE,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS;gBACxB,cAAc,EAAE,kBAAkB;aACnC;SACF,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAOD,KAAK,CAAC,kBAAkB,CACtB,SAAiB,EACjB,OAA8B;QAE9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAC9B,8BAA8B,EAC9B,OAAO,EACP;YACE,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS;gBACxB,cAAc,EAAE,kBAAkB;aACnC;SACF,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAOD,KAAK,CAAC,gBAAgB,CACpB,SAAiB,EACjB,MAA2B;QAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7B,uCAAuC,EACvC;YACE,MAAM;YACN,OAAO,EAAE;gBACP,aAAa,EAAE,SAAS;aACzB;SACF,CACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAA,oBAAa,EAAC,SAAS,CAAC,CAAC;QAChD,OAAO,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;CACF,CAAA;AAlGY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;qCAEwB,mBAAW;GADnC,yBAAyB,CAkGrC"}

package/manual.txt

@@ -0,0 +1,47 @@
+ProspayAuthService
+  - authenticate(): POST {baseUrl}/auth/api/v1.0/authenz/token?action=verify
+      Inputs: headers => timestamp (epoch seconds), resourceId (productId), keyhash (bcrypt of `${timestamp}.${productId}.${productApiKey}`); no body.
+      Success: `{ status, message?, token?, ... }` (auth token payload). Base URL defaults to https://sandbox.prospay.tech.
+
+ProspayCustomerService
+  - createCustomer(authToken, payload): POST /customer/api/v3.0/customers
+      Inputs (body): productId, productCustomerId, orgName, customerType, contacts { email, mobileNumber }.
+      Success: `{ status, message, data: { customerId, customerData, virtualAccountNo, uin, qrString, isDeliveryAllowed, creditPeriodInDays } }`.
+  - updateCustomer(authToken, customerId, payload): PATCH /customer/api/v3.0/customers/{customerId}/
+      Inputs (body): any subset of creditPeriodInDays, uin, preferences { isMainOrg, mainOrgCustomerId, shareWallet, customerIdForWallet, shareKYC, customerIdForKYC, paymentType }, isDeliveryAllowed, billingType, invoiceGenerationPeriod, CIN, status, creditlimit, contacts { email, mobileNumber }, industryType, KYC { businessType, isGSTRegistered, GST, customerConsent }, address { line1, line2, city, state, pincode, stateCode }, productId.
+      Success: `{ status, message, data: { uin, creditPeriodInDays, customerId, customerData, kycData, creditLimit: { walletId, oldCreditLimit, newCreditLimit, newAvailableBalance, currency, updatedAt } } }`.
+  - updateCustomerStatus(authToken, customerId, payload): PATCH /customer/api/v3.0/customers/{customerId}/
+      Inputs (body): productId, status.
+      Success: `{ status, message, data: { uin, creditPeriodInDays, customerId, customerData } }`.
+  - getCustomerById(authToken, customerId): GET /customer/api/v3.0/customers/{customerId}?filter=all
+      Inputs: headers => Authorization; query => filter=all.
+      Success: `{ status, message, data: [customerProfile...], cached }` (profiles include contact, KYC, credit, bank, address, flags).
+  - searchCustomers(authToken, params): GET /customer/api/v3.0/customers/search
+      Inputs (query): filter?, mobileNumber?, productCustomerId?, customerType?; headers => Authorization.
+      Success: `{ status, message, data }` (structure depends on search result).
+
+ProspayInvoiceService
+  - generateBulkInvoice(authToken, payload, callbackUrl?): POST /invoices/api/v2.0/generateBulkInvoice
+      Inputs (body): templateName, productId, startDate (YYYY-MM-DD), endDate (YYYY-MM-DD), buyer_customerId, seller_customerId, due_date (YYYY-MM-DD), invoice_no, invoice_date (DD-MM-YYYY), invoice_period; headers => Authorization, Content-Type, optional callback-url.
+      Success: `{ status: "ok", message: "Process initiated for generating invoice", refId }`.
+  - generateInvoice(authToken, payload, callbackUrl?): POST /invoices/api/v2.0/generateInvoice
+      Inputs (body): templateName, productId, startDate (YYYY-MM-DD), endDate (YYYY-MM-DD), buyer_customerId, seller_customerId, due_date (YYYY-MM-DD), invoice_no, invoice_date (DD-MM-YYYY), invoice_period; headers => Authorization, Content-Type, optional callback-url.
+      Success: `{ status: "ok", message: "Process initiated for generating invoice", refId }`.
+  - getInvoiceStatus(authToken, refId): GET /invoices/api/v2.0/invoice-status/{refId}
+      Inputs: path => refId; headers => Authorization, Content-Type.
+      Success: `{ refId, overallStatus, templateName, productId, statistics: { total, success, failed, processing }, invoices: [{ invoiceId, status, createdAt, customerId, pdfUrl?, completedAt?, error?, errorDetails? }] }`.
+
+ProspayTransactionService
+  - createTransaction(authToken, payload): POST /uts/api/transactions
+      Inputs (body): customerId, entityType (e.g., "order"), referenceId, currency (e.g., "INR"), vertical (e.g., "customer"), charges: [{ head, amount, hsnOrSac, isBillable, absorbedBy, transactionType, chargedAt?, appliedOn?, tags?, breakup?, metadata? }].
+      Success: `{ success: true, requestId, path, timestamp, data: { transactionId, summary: { transactionAmount, billableAmount, totalCreditAmount, totalDebitAmount } } }`.
+  - addChargesToTransaction(authToken, transactionId, payload): POST /uts/api/transactions/{transactionId}/charges
+      Inputs (body): charges: [{ head, amount, hsnOrSac, isBillable, absorbedBy, transactionType, chargedAt?, appliedOn?, tags?, breakup?, metadata? }]; path => transactionId.
+      Success: `{ success: true, requestId, path, timestamp, data: { transactionId, addedChargesSummary: { transactionAmount, billableAmount, totalCreditAmount, totalDebitAmount }, transactionSummary: { transactionAmount, billableAmount, totalCreditAmount, totalDebitAmount } } }`.
+  - searchTransactions(authToken, payload): POST /uts/api/transactions/search
+      Inputs (body): page, limit, transactionFilters { customerIds?, transactionDateRange? { start, end } }.
+      Success: `{ success: true, requestId, path, timestamp, data: { items: [...], pagination: { total, page, limit, totalPages } } }`.
+  - getChargeSummary(authToken, params): GET /uts/api/transactions/charge-summary/
+      Inputs (query): startDate (YYYY-MM-DD), endDate (YYYY-MM-DD); headers => Authorization.
+      Success: `{ success: true, requestId, path, timestamp, data: [{ chargeHead, hsnOrSac, vertical, taxableAmount, cgstRate, cgst, sgstRate, sgst, igstRate, igst, totalTaxRate, totalTax, netAmount }, ...] }`.
+

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "prospay-sdk",
+  "version": "1.0.0",
+  "description": "NestJS-based SDK for Prospay customer onboarding, order, and invoicing APIs.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:watch": "ts-node-dev --respawn --transpile-only src/index.ts",
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://preetihaloli1@bitbucket.org/delcaperadmin/prospay-sdk.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://bitbucket.org/delcaperadmin/prospay-sdk/issues"
+  },
+  "homepage": "https://bitbucket.org/delcaperadmin/prospay-sdk#readme",
+  "dependencies": {
+    "@nestjs/axios": "^4.0.1",
+    "@nestjs/common": "^11.1.9",
+    "@nestjs/core": "^11.1.9",
+    "bcryptjs": "^3.0.3",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "ts-node": "^10.9.2",
+    "ts-node-dev": "^2.0.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/auth/auth.service.ts

@@ -0,0 +1,63 @@
+import { Inject, Injectable } from '@nestjs/common';
+import { HttpService } from '@nestjs/axios';
+import { lastValueFrom } from 'rxjs';
+import * as bcrypt from 'bcryptjs';
+import { PROSPAY_SDK_OPTIONS, ProspaySdkOptions } from '../sdk.config';
+
+@Injectable()
+export class ProspayAuthService {
+  private readonly baseUrl: string;
+
+  constructor(
+    private readonly http: HttpService,
+    @Inject(PROSPAY_SDK_OPTIONS)
+    private readonly options: ProspaySdkOptions,
+  ) {
+    this.baseUrl = options.baseUrl ?? 'https://sandbox.prospay.tech';
+  }
+
+  /**
+   * Generate a bcrypt hash for the auth header based on:
+   *   ${timestamp}.${productId}.${productApiKey}
+   */
+  private async generateKeyHash(timestamp: number): Promise<string> {
+    const raw = `${timestamp}.${this.options.productId}.${this.options.productApiKey}`;
+    // Default salt rounds = 10 as per typical bcrypt usage.
+    const saltRounds = 10;
+    return bcrypt.hash(raw, saltRounds);
+  }
+
+  /**
+   * Call Prospay auth endpoint (sandbox by default) and return the response.
+   * Endpoint:
+   *   POST {baseUrl}/auth/api/v1.0/authenz/token?action=verify
+   * Headers:
+   *   timestamp: epoch seconds
+   *   resourceId: productId
+   *   keyhash: bcrypt hash of `${timestamp}.${productId}.${productApiKey}`
+   */
+  async authenticate(): Promise<any> {
+    const timestamp = Math.floor(new Date().getTime() / 1000);
+    const keyhash = await this.generateKeyHash(timestamp);
+
+    const url = `${this.baseUrl}/auth/api/v1.0/authenz/token`;
+
+    const response$ = this.http.post(
+      url,
+      null,
+      {
+        params: { action: 'verify' },
+        headers: {
+          timestamp: String(timestamp),
+          resourceId: this.options.productId,
+          keyhash,
+        },
+      },
+    );
+
+    const response = await lastValueFrom(response$);
+    return response.data;
+  }
+}
+
+