fairsure-checkout-sdk 1.0.0

package/dist/components/usePaymentCheckout.d.ts

@@ -0,0 +1,61 @@
+export declare function usePaymentCheckout(amount: number, requestId: string, customerEmail: string, customerName: string, customerPhone: string, onSuccess?: (reference: string) => void): {
+    selectedMethod: string;
+    cardNumber: string;
+    expiryDate: string;
+    cvv: string;
+    selectedBank: {
+        name: string;
+        code: string;
+    } | null;
+    showBankDropdown: boolean;
+    pin: string;
+    message: string;
+    otp: string;
+    copied: boolean;
+    showPin: boolean;
+    showOtp: boolean;
+    cardcontinue: boolean;
+    loading: boolean;
+    ussdBanks: never[];
+    transferDetail: {
+        accountName: string;
+        accountNumber: string;
+        bankName: string;
+        amount: number;
+        validityPeriodMins: number;
+        transactionReference: string;
+    };
+    cardDetails: {
+        transactionRef: string;
+        paymentId: string;
+    };
+    timeLeft: number;
+    ussdBankResponse: {
+        ussdString: string;
+        codeRef: string;
+        amount: string;
+    };
+    setSelectedMethod: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setCardNumber: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setExpiryDate: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setCvv: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setSelectedBank: import("react").Dispatch<import("react").SetStateAction<{
+        name: string;
+        code: string;
+    } | null>>;
+    setShowBankDropdown: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setPin: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setOtp: import("react").Dispatch<import("react").SetStateAction<string>>;
+    setcardcontinue: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setShowOtp: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    formatTime: (seconds: number) => string;
+    formatAmount: (value: number) => string;
+    formatCardNumber: (value: string) => string;
+    formatExpiry: (value: string) => string;
+    handleCopy: (text: string) => Promise<void>;
+    handleCardPayment: () => Promise<any>;
+    verifyTransfer: () => Promise<any>;
+    verifyCardPayment: () => Promise<any>;
+    resetForm: () => void;
+    verifyUssd: () => Promise<void>;
+};

package/dist/components/usePaymentCheckout.js

@@ -0,0 +1,398 @@
+import axios from "axios";
+import * as Clipboard from "expo-clipboard";
+import { useEffect, useState } from "react";
+import { Dimensions, Platform } from "react-native";
+const { width, height } = Dimensions.get("window");
+export function usePaymentCheckout(amount, requestId, customerEmail, customerName, customerPhone, onSuccess) {
+    const [selectedMethod, setSelectedMethod] = useState("card");
+    const [cardNumber, setCardNumber] = useState("");
+    const [expiryDate, setExpiryDate] = useState("");
+    const [cvv, setCvv] = useState("");
+    const [selectedBank, setSelectedBank] = useState(null);
+    const [showBankDropdown, setShowBankDropdown] = useState(false);
+    const [pin, setPin] = useState("");
+    const [otp, setOtp] = useState("");
+    const [message, setMessage] = useState("");
+    const [copied, setCopied] = useState(false);
+    const [showPin, setShowPin] = useState(false);
+    const [showOtp, setShowOtp] = useState(false);
+    const [cardcontinue, setcardcontinue] = useState(false);
+    const [loading, setLoading] = useState(false);
+    const [ussdBanks, setUssdBanks] = useState([]);
+    const [ussdBankResponse, setUssdBankResponse] = useState({
+        ussdString: "",
+        codeRef: "",
+        amount: "",
+    });
+    const [transferDetail, setTransferDetail] = useState({
+        accountName: "",
+        accountNumber: "",
+        bankName: "",
+        amount: 0,
+        validityPeriodMins: 0,
+        transactionReference: "",
+    });
+    const [cardDetails, setCardDetails] = useState({
+        transactionRef: "",
+        paymentId: "",
+    });
+    const [timeLeft, setTimeLeft] = useState(0);
+    // Timer logic
+    useEffect(() => {
+        if (transferDetail.validityPeriodMins > 0) {
+            setTimeLeft(transferDetail.validityPeriodMins * 60);
+        }
+    }, [transferDetail.validityPeriodMins]);
+    useEffect(() => {
+        if (timeLeft <= 0)
+            return;
+        const timer = setInterval(() => {
+            setTimeLeft((prev) => {
+                if (prev <= 1) {
+                    clearInterval(timer);
+                    return 0;
+                }
+                return prev - 1;
+            });
+        }, 1000);
+        return () => clearInterval(timer);
+    }, [timeLeft]);
+    // Fetch transfer details or USSD banks based on selected method
+    useEffect(() => {
+        if (selectedMethod === "transfer" || selectedMethod === "card") {
+            fetchTransferDetails();
+        }
+        else if (selectedMethod === "ussd") {
+            getBanks();
+        }
+    }, [selectedMethod]);
+    const fetchTransferDetails = async () => {
+        var _a;
+        setLoading(true);
+        try {
+            const payload = {
+                amount,
+                accountName: "Fairsure",
+                isBill: true,
+                requestId,
+            };
+            const res = await axios.post("https://api.fairsurepayment.com.ng/api/pub/generate-account", payload, {
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.51.0",
+                },
+            });
+            setTransferDetail((_a = res === null || res === void 0 ? void 0 : res.data) === null || _a === void 0 ? void 0 : _a.data);
+        }
+        catch (error) {
+            console.log("FETCH ERROR:", error);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    const generateUssdCode = async () => {
+        var _a;
+        setLoading(true);
+        const payload = {
+            amount,
+            requestId,
+            bankCode: selectedBank === null || selectedBank === void 0 ? void 0 : selectedBank.code,
+        };
+        try {
+            const res = await axios.post("https://api.fairsurepayment.com.ng/api/pub/generate-ussd", payload, {
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.51.0",
+                },
+            });
+            setUssdBankResponse((_a = res === null || res === void 0 ? void 0 : res.data) === null || _a === void 0 ? void 0 : _a.data);
+        }
+        catch (error) {
+            console.log("FETCH ERROR:", error);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    const verifyUssd = async () => {
+        try {
+            setLoading(true);
+            const payload = {
+                codeReference: ussdBankResponse === null || ussdBankResponse === void 0 ? void 0 : ussdBankResponse.codeRef,
+                amount: ussdBankResponse === null || ussdBankResponse === void 0 ? void 0 : ussdBankResponse.amount,
+            };
+            const res = await axios.post("https://api.fairsurepayment.com.ng/api/pub/ussd-status", payload, {
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.51.0",
+                },
+            });
+            onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess(cardDetails.transactionRef);
+            setLoading(false);
+        }
+        catch (error) {
+            console.log("FETCH ERROR:", error);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    useEffect(() => {
+        if (selectedBank) {
+            generateUssdCode();
+        }
+    }, [selectedBank]);
+    const getBanks = async () => {
+        var _a;
+        setLoading(true);
+        try {
+            setLoading(true);
+            const res = await axios.get("https://api.fairsurepayment.com.ng/api/pub/list-ussd-banks", {
+                timeout: 15000,
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.36.0",
+                },
+            });
+            const banks = res.data.data.map((bank) => ({
+                name: bank.BankName,
+                code: bank.BankCode,
+            }));
+            setLoading(false);
+            setUssdBanks(banks);
+        }
+        catch (error) {
+            console.log("Failed to fetch banks", (_a = error.response) === null || _a === void 0 ? void 0 : _a.data);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    const handleCopy = async (text) => {
+        await Clipboard.setStringAsync(text);
+        setCopied(true);
+        setTimeout(() => setCopied(false), 2000);
+    };
+    const formatTime = (seconds) => {
+        const m = Math.floor(seconds / 60);
+        const s = seconds % 60;
+        return `${m.toString().padStart(2, "0")}:${s.toString().padStart(2, "0")}`;
+    };
+    const formatAmount = (value) => {
+        return value.toLocaleString("en-NG", {
+            minimumFractionDigits: 2,
+            maximumFractionDigits: 2,
+        });
+    };
+    const formatCardNumber = (value) => {
+        const v = value.replace(/\s+/g, "").replace(/[^0-9]/gi, "");
+        const matches = v.match(/\d{4,16}/g);
+        const match = (matches && matches[0]) || "";
+        const parts = [];
+        for (let i = 0; i < match.length; i += 4) {
+            parts.push(match.substring(i, i + 4));
+        }
+        return parts.length ? parts.join(" ") : value;
+    };
+    const formatExpiry = (value) => {
+        const v = value.replace(/\s+/g, "").replace(/[^0-9]/gi, "");
+        if (v.length >= 2) {
+            return v.slice(0, 2) + "/" + v.slice(2, 4);
+        }
+        return v;
+    };
+    const completeCard = async (data) => {
+        var _a, _b, _c;
+        setLoading(true);
+        try {
+            const payload = {
+                customerId: customerEmail,
+                amount: String(amount),
+                transactionRef: requestId,
+                currency: "NGN",
+                callbackUrl: "https://yourcallbackurl.com",
+                isBill: "true",
+                data: data,
+                deviceInformation: {
+                    deviceChannel: "MOBILE",
+                    userAgentBrowserValue: `ReactNative/${Platform.OS}`,
+                    httpBrowserLanguage: "en-NG",
+                    httpBrowserJavaEnabled: false,
+                    httpBrowserJavaScriptEnabled: true,
+                    httpBrowserColorDepth: 32,
+                    httpBrowserScreenHeight: Math.round(height),
+                    httpBrowserScreenWidth: Math.round(width),
+                    httpBrowserTimeDifference: `${-new Date().getTimezoneOffset()}`,
+                },
+            };
+            const res = await axios.post("https://api.fairsurepayment.com.ng/api/pub/card-payment", payload, {
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.51.0",
+                },
+            });
+            setLoading(false);
+            return res.data;
+        }
+        catch (error) {
+            setLoading(false);
+            if (axios.isAxiosError(error)) {
+                console.log("STATUS:", (_a = error.response) === null || _a === void 0 ? void 0 : _a.status);
+                console.log("DATA:", (_b = error.response) === null || _b === void 0 ? void 0 : _b.data);
+                console.log("HEADERS:", (_c = error.response) === null || _c === void 0 ? void 0 : _c.headers);
+            }
+            else {
+                console.log("UNKNOWN ERROR:", error);
+            }
+        }
+    };
+    const handleCardPayment = async () => {
+        var _a, _b;
+        setLoading(true);
+        try {
+            const payload = {
+                pan: cardNumber.replace(/\s/g, ""),
+                expiryDate: expiryDate.replace("/", ""),
+                cvv,
+                pin,
+            };
+            const res = await axios.post("https://api.fairsurepayment.com.ng/api/pub/encrypt-test", payload, {
+                timeout: 15000,
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.51.0",
+                },
+            });
+            const data = await completeCard((_a = res === null || res === void 0 ? void 0 : res.data) === null || _a === void 0 ? void 0 : _a.data);
+            setMessage((_b = data === null || data === void 0 ? void 0 : data.data) === null || _b === void 0 ? void 0 : _b.message);
+            setCardDetails(data === null || data === void 0 ? void 0 : data.data);
+            setOtp("");
+            setPin("");
+            setShowOtp(true);
+            return data;
+        }
+        catch (error) {
+            console.log(error);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    const verifyCardPayment = async () => {
+        setLoading(true);
+        try {
+            const payload = {
+                transactionId: cardDetails === null || cardDetails === void 0 ? void 0 : cardDetails.transactionRef,
+                paymentId: cardDetails === null || cardDetails === void 0 ? void 0 : cardDetails.paymentId,
+                // eciFlag: "07",
+                otp: otp,
+                customerName,
+                customerPhone,
+                customerEmail,
+            };
+            const res = await axios.post("https://api.fairsurepayment.com.ng/api/pub/submit-otp", payload, {
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.36.0",
+                },
+            });
+            onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess(transferDetail.transactionReference);
+            setLoading(false);
+            return res === null || res === void 0 ? void 0 : res.data;
+        }
+        catch (error) {
+            setLoading(false);
+            console.log("ERROR", error);
+        }
+    };
+    const verifyTransfer = async () => {
+        var _a;
+        setLoading(true);
+        try {
+            const res = await axios.get(`https://api.fairsurepayment.com.ng/api/pub/transfer-status?transactionReference=${transferDetail === null || transferDetail === void 0 ? void 0 : transferDetail.transactionReference}`, {
+                timeout: 15000,
+                headers: {
+                    Accept: "application/json",
+                    "Content-Type": "application/json",
+                    publickey: "LIVE_7AXSCCY8R3HABAN14QP7",
+                    "User-Agent": "PostmanRuntime/7.36.0",
+                },
+            });
+            onSuccess === null || onSuccess === void 0 ? void 0 : onSuccess(transferDetail.transactionReference);
+            return res === null || res === void 0 ? void 0 : res.data;
+        }
+        catch (error) {
+            console.log("Failed to Verify transfer", (_a = error.response) === null || _a === void 0 ? void 0 : _a.data);
+        }
+        finally {
+            setLoading(false);
+        }
+    };
+    const resetForm = () => {
+        setCardNumber("");
+        setExpiryDate("");
+        setCvv("");
+        setSelectedBank(null);
+        setcardcontinue(false);
+        setSelectedMethod("card");
+    };
+    return {
+        // State
+        selectedMethod,
+        cardNumber,
+        expiryDate,
+        cvv,
+        selectedBank,
+        showBankDropdown,
+        pin,
+        message,
+        otp,
+        copied,
+        showPin,
+        showOtp,
+        cardcontinue,
+        loading,
+        ussdBanks,
+        transferDetail,
+        cardDetails,
+        timeLeft,
+        ussdBankResponse,
+        // Setters
+        setSelectedMethod,
+        setCardNumber,
+        setExpiryDate,
+        setCvv,
+        setSelectedBank,
+        setShowBankDropdown,
+        setPin,
+        setOtp,
+        setcardcontinue,
+        setShowOtp,
+        // Utilities
+        formatTime,
+        formatAmount,
+        formatCardNumber,
+        formatExpiry,
+        handleCopy,
+        handleCardPayment,
+        verifyTransfer,
+        verifyCardPayment,
+        resetForm,
+        verifyUssd,
+    };
+}

package/dist/context/CheckoutProvider.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+export declare function CheckoutProvider({ children }: {
+    children: React.ReactNode;
+}): React.JSX.Element;
+export declare const useCheckoutContext: () => any;

package/dist/context/CheckoutProvider.js

@@ -0,0 +1,16 @@
+import React, { createContext, useContext, useState } from "react";
+import Checkout from "../components/PaystackCheckout";
+const CheckoutContext = createContext(null);
+export function CheckoutProvider({ children }) {
+    const [config, setConfig] = useState(null);
+    const openCheckout = (options) => {
+        setConfig(options);
+    };
+    const closeCheckout = () => setConfig(null);
+    return (<CheckoutContext.Provider value={{ openCheckout }}>
+      {children}
+
+      {config && (<Checkout amount={config.amount} merchantName={config.merchantName} onSuccess={config.onSuccess} onClose={closeCheckout} requestId={config.requestId} customerEmail={config.customerEmail} customerName={config.customerName} customerPhone={config.customerPhone}/>)}
+    </CheckoutContext.Provider>);
+}
+export const useCheckoutContext = () => useContext(CheckoutContext);

package/dist/hooks/useCheckout.d.ts

@@ -0,0 +1 @@
+export declare function useCheckout(): any;

package/dist/hooks/useCheckout.js

@@ -0,0 +1,8 @@
+import { useCheckoutContext } from "../context/CheckoutProvider";
+export function useCheckout() {
+    const ctx = useCheckoutContext();
+    if (!ctx) {
+        throw new Error("usePaystackCheckout must be used inside CheckoutProvider");
+    }
+    return ctx;
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { CheckoutProvider } from "./context/CheckoutProvider";
+export { useCheckout } from "./hooks/useCheckout";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { CheckoutProvider } from "./context/CheckoutProvider";
+export { useCheckout } from "./hooks/useCheckout";

package/dist/types.d.ts

@@ -0,0 +1,9 @@
+export interface CheckoutConfig {
+    amount: number;
+    merchantName?: string;
+    onSuccess?: (reference: string) => void;
+    requestId: string;
+    customerEmail: string;
+    customerName: string;
+    customerPhone: string;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "fairsure-checkout-sdk",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  },
+  "scripts": {
+    "build": "tsc",
+    "pack": "npm pack"
+  },
+  "dependencies": {
+    "@expo/vector-icons": "^15.0.3",
+    "axios": "^1.13.4",
+    "expo-clipboard": "^8.0.8"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.10",
+    "typescript": "^5.9.3"
+  }
+}