@payloqa/payment-widget 1.0.0

package/dist/services/paymentService.d.ts

@@ -0,0 +1,16 @@
+import { PaymentServiceConfig, CreatePaymentRequest, CreatePaymentResponse, VerifyOTPRequest, VerifyOTPResponse, ResendOTPRequest, ResendOTPResponse, GetPaymentStatusResponse, CancelPaymentRequest, CancelPaymentResponse } from "../types/payment";
+declare class PaymentService {
+    private readonly config;
+    constructor(config: PaymentServiceConfig);
+    private makeRequest;
+    createPayment(request: CreatePaymentRequest): Promise<CreatePaymentResponse>;
+    verifyOTP(paymentId: string, request: VerifyOTPRequest): Promise<VerifyOTPResponse>;
+    resendOTP(paymentId: string, request: ResendOTPRequest): Promise<ResendOTPResponse>;
+    getPaymentStatus(paymentId: string): Promise<GetPaymentStatusResponse>;
+    cancelPayment(paymentId: string, request?: CancelPaymentRequest): Promise<CancelPaymentResponse>;
+    getPlatformInfo(): Promise<{
+        logo_url?: string;
+    }>;
+}
+export default PaymentService;
+//# sourceMappingURL=paymentService.d.ts.map

package/dist/services/paymentService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paymentService.d.ts","sourceRoot":"","sources":["../../src/services/paymentService.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAK1B,cAAM,cAAc;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,EAAE,oBAAoB;YAI1B,WAAW;IAsCnB,aAAa,CACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAc3B,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAOvB,SAAS,CACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAOvB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAMtE,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,CAAC;IAO3B,eAAe,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAkBxD;AAED,eAAe,cAAc,CAAC"}

package/dist/types/payment.d.ts

@@ -0,0 +1,150 @@
+export interface PaymentServiceConfig {
+    apiKey: string;
+    platformId: string;
+    baseUrl?: string;
+}
+export interface CreatePaymentRequest {
+    amount: number;
+    currency: string;
+    payment_method: "mobile_money" | "card";
+    phone_number: string;
+    network?: "mtn" | "vodafone" | "airteltigo";
+    redirect_url?: string;
+    webhook_url?: string;
+    reference?: string;
+    metadata?: Record<string, any>;
+    payee_id?: string;
+    offline?: boolean;
+    order_id?: string;
+    transaction_id?: string;
+    payer_id?: string;
+    payment_flow?: "direct" | "escrow";
+}
+export interface CreatePaymentResponse {
+    success: boolean;
+    data?: {
+        payment_id: string;
+        payment_url: string;
+        otp_required: boolean;
+        otp_sent: boolean;
+        message: string;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface VerifyOTPRequest {
+    phone_number: string;
+    otp_code: string;
+}
+export interface VerifyOTPResponse {
+    success: boolean;
+    data?: {
+        payment_id: string;
+        status: PaymentStatus;
+        message: string;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface ResendOTPRequest {
+    phone_number: string;
+}
+export interface ResendOTPResponse {
+    success: boolean;
+    data?: {
+        payment_id: string;
+        message: string;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface GetPaymentStatusResponse {
+    success: boolean;
+    data?: PaymentData;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface CancelPaymentRequest {
+    reason?: string;
+    metadata?: Record<string, any>;
+}
+export interface CancelPaymentResponse {
+    success: boolean;
+    data?: {
+        payment_id: string;
+        status: PaymentStatus;
+        message: string;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+export interface PaymentData {
+    payment_id: string;
+    status: PaymentStatus;
+    amount: number | string;
+    currency: string;
+    payment_method: "mobile_money" | "card";
+    phone_number?: string;
+    network?: "mtn" | "vodafone" | "airteltigo";
+    reference?: string;
+    created_at: string;
+    updated_at: string;
+    paid_at?: string;
+    metadata?: Record<string, any>;
+}
+export type PaymentStatus = "pending" | "processing" | "completed" | "failed" | "cancelled" | "expired";
+export type PaymentWidgetDisplayMode = "modal" | "inline" | "fullpage";
+export interface PaymentWidgetConfig {
+    apiKey: string;
+    platformId: string;
+    apiUrl?: string;
+    amount: number;
+    currency?: string;
+    redirect_url?: string;
+    payeeId?: string;
+    orderId?: string;
+    transactionId?: string;
+    payerId?: string;
+    webhookUrl?: string;
+    reference?: string;
+    metadata?: Record<string, any>;
+    displayMode?: PaymentWidgetDisplayMode;
+    primaryColor?: string;
+    logoUrl?: string;
+    onSuccess?: (payment: PaymentData) => void;
+    onError?: (error: PaymentError) => void;
+    onClose?: () => void;
+}
+export interface PaymentError {
+    message: string;
+    code?: string;
+    details?: any;
+}
+export type PaymentWidgetState = "phone-input" | "otp-input" | "verifying" | "success" | "failed" | "loading";
+export type MobileNetwork = "mtn" | "vodafone" | "airteltigo";
+export interface NetworkOption {
+    value: MobileNetwork;
+    label: string;
+    icon?: string;
+}
+export type PaymentRedirectStatus = "completed" | "failed" | "cancelled" | "pending";
+export interface PaymentRedirectParams {
+    payment_id: string;
+    status: PaymentRedirectStatus;
+    amount?: number;
+    currency?: string;
+    reference?: string;
+    reason?: string;
+    message?: string;
+}
+//# sourceMappingURL=payment.d.ts.map

package/dist/types/payment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../src/types/payment.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -0,0 +1,11 @@
+import type { PaymentData, PaymentRedirectStatus } from "../types/payment";
+export declare const formatPhoneNumber: (phoneNumber: string) => string;
+/**
+ * Validates that a redirect URL is HTTPS
+ */
+export declare function validateRedirectUrl(url: string): boolean;
+/**
+ * Builds a redirect URL with query parameters based on payment status
+ */
+export declare function buildRedirectUrl(redirectUrl: string, paymentId: string, status: PaymentRedirectStatus, paymentData?: PaymentData): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,eAAO,MAAM,iBAAiB,GAAI,aAAa,MAAM,KAAG,MAoBvD,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,qBAAqB,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,MAAM,CA+BR"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "@payloqa/payment-widget",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "React-based payment widget for Payloqa",
+  "main": "dist/index.umd.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.umd.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./styles": {
+      "default": "./dist/payment-widget.css"
+    },
+    "./dist/payment-widget.css": "./dist/payment-widget.css"
+  },
+  "scripts": {
+    "dev": "vite",
+    "build": "rollup -c && node scripts/build-css.js",
+    "build:css": "node scripts/build-css.js",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "dependencies": {
+    "formik": "^2.4.5",
+    "react-otp-input": "^3.1.1",
+    "react-phone-number-input": "^3.4.12",
+    "react-select": "^5.8.0",
+    "yup": "^1.3.3"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/plugin-terser": "^0.4.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@tailwindcss/forms": "^0.5.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "@types/react-phone-number-input": "^3.0.17",
+    "@types/react-select": "^5.0.0",
+    "@vitejs/plugin-react": "^4.7.0",
+    "autoprefixer": "^10.0.0",
+    "cssnano": "^6.0.0",
+    "postcss": "^8.5.6",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "rollup": "^4.0.0",
+    "rollup-plugin-dts": "^6.0.0",
+    "rollup-plugin-postcss": "^4.0.0",
+    "tailwindcss": "^3.0.0",
+    "vite": "^5.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "payloqa",
+    "payment",
+    "widget",
+    "react",
+    "mobile-money",
+    "payment-processing"
+  ],
+  "author": "Payloqa Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/payloqa/payloqa-widgets.git",
+    "directory": "packages/payment-widget"
+  },
+  "homepage": "https://github.com/payloqa/payloqa-widgets#readme",
+  "bugs": {
+    "url": "https://github.com/payloqa/payloqa-widgets/issues"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}