@voxepay/checkout 0.3.2 → 0.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxepay/checkout",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "Modern payment checkout modal for VoxePay - beautiful, fast, and secure",
   "author": "VoxePay",
   "license": "MIT",
@@ -23,6 +23,7 @@
   },
   "files": [
     "dist",
+    "src",
     "README.md"
   ],
   "scripts": {

package/src/api/client.ts

@@ -0,0 +1,110 @@
+/**
+ * VoxePay Payment API Client
+ * Handles communication with the VoxePay payment gateway
+ */
+
+const DEFAULT_BASE_URL = 'https://devpay.voxepay.app';
+
+export interface InitiatePaymentRequest {
+    organizationId: string;
+    transactionRef: string;
+    customerId?: string;
+    customerEmail?: string;
+    customerPhone?: string;
+    amount: number;
+    currency: string;
+    paymentMethod: 'CARD' | 'BANK_TRANSFER';
+    authData: string;
+    narration?: string;
+}
+
+export interface InitiatePaymentResponse {
+    paymentId: string;
+    transactionId: string;
+    transactionRef: string;
+    status: string;
+    message: string;
+    eciFlag?: string;
+    [key: string]: unknown;
+}
+
+export interface ValidateOTPRequest {
+    paymentId: string;
+    otp: string;
+    transactionId: string;
+    eciFlag?: string;
+    organizationId: string;
+}
+
+export interface ValidateOTPResponse {
+    status: string;
+    message: string;
+    paymentId: string;
+    transactionRef?: string;
+    amount?: number;
+    currency?: string;
+    [key: string]: unknown;
+}
+
+export interface ResendOTPRequest {
+    transactionRef: string;
+    organizationId: string;
+}
+
+export class VoxePayApiClient {
+    private apiKey: string;
+    private baseUrl: string;
+
+    constructor(apiKey: string, baseUrl?: string) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl || DEFAULT_BASE_URL;
+    }
+
+    private async request<T>(endpoint: string, body: unknown): Promise<T> {
+        const url = `${this.baseUrl}${endpoint}`;
+
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'X-API-Key': this.apiKey,
+                'Accept': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+
+        const data = await response.json();
+
+        if (!response.ok) {
+            const errorMessage = data?.message || data?.error || `Request failed with status ${response.status}`;
+            const error: any = new Error(errorMessage);
+            error.code = data?.code || `HTTP_${response.status}`;
+            error.status = response.status;
+            error.data = data;
+            throw error;
+        }
+
+        return data as T;
+    }
+
+    /**
+     * Initiate a card payment
+     */
+    async initiatePayment(data: InitiatePaymentRequest): Promise<InitiatePaymentResponse> {
+        return this.request<InitiatePaymentResponse>('/api/v1/payments/initiate', data);
+    }
+
+    /**
+     * Validate OTP for a payment
+     */
+    async validateOTP(data: ValidateOTPRequest): Promise<ValidateOTPResponse> {
+        return this.request<ValidateOTPResponse>('/api/v1/payments/validate-otp', data);
+    }
+
+    /**
+     * Resend OTP for a payment
+     */
+    async resendOTP(data: ResendOTPRequest): Promise<void> {
+        await this.request<unknown>('/api/v1/payments/resend-otp', data);
+    }
+}