@kuvarpay/sdk 1.0.0 → 1.2.0

package/index.d.ts

@@ -78,8 +78,6 @@ export class KuvarPayServer {
     toDate?: string;
   }): Promise<any>;
 
-  refundTransaction(transactionId: string, data?: { amount?: number; reason?: string }): Promise<any>;
-  getExpiredTransactions(): Promise<any>;
   getOptimalTransferFee(amount: number, currency?: string): Promise<any>;
   sendInvoiceEmail(sessionId: string): Promise<any>;
 

package/index.js

@@ -10,10 +10,10 @@
 
 const crypto = require('crypto');
 
-const DEFAULT_BASE = (process.env.PAYMENT_API_BASE_URL
-  || process.env.PAYMENT_SERVER_URL
-  || process.env.NEXT_PUBLIC_PAYMENT_API_BASE_URL
-  || 'http://localhost:3002').replace(/\/+$/, '');
+const DEFAULT_BASE = (process.env.KUVARPAY_API_BASE_URL
+  || process.env.PAYMENT_API_BASE_URL
+  || 'https://payment.kuvarpay.com'
+).replace(/\/$/, '');
 
 class KuvarPayServer {
   /**
@@ -39,7 +39,6 @@ class KuvarPayServer {
   _headers(extra = {}) {
     return Object.assign({
       'Accept': 'application/json',
-      'Authorization': this.secretApiKey,
       'X-API-Key': this.secretApiKey,
       'X-Business-ID': this.businessId,
     }, extra);
@@ -143,6 +142,22 @@ class KuvarPayServer {
     };
   }
 
+  /**
+   * Update transaction status (Admin/Internal)
+   * PATCH /api/v1/transactions/{id}/status
+   */
+  async updateTransactionStatus(transactionId, data) {
+    return this._patch(`/api/v1/transactions/${encodeURIComponent(transactionId)}/status`, data);
+  }
+
+  /**
+   * Simulate a payment (Sandbox only)
+   * POST /api/v1/transactions/{id}/demo-pay
+   */
+  async demoPay(transactionId) {
+    return this._post(`/api/v1/transactions/${encodeURIComponent(transactionId)}/demo-pay`, {});
+  }
+
   /**
    * Get transaction status by merchant reference
    * GET /api/v1/transactions/status/{reference}
@@ -162,22 +177,6 @@ class KuvarPayServer {
     return this._get(path);
   }
 
-  /**
-   * Refund a transaction
-   * @param {string} transactionId 
-   * @param {Object} data - { amount?, reason? }
-   */
-  async refundTransaction(transactionId, data = {}) {
-    return this._post(`/api/v1/transactions/${encodeURIComponent(transactionId)}/refund`, data);
-  }
-
-  /**
-   * Get expired transactions
-   */
-  async getExpiredTransactions() {
-    return this._get('/api/v1/transactions/expired');
-  }
-
   /**
    * Calculate fees
    */
@@ -249,7 +248,7 @@ class KuvarPayServer {
     const payload = Object.assign({}, transactionData, {
       businessId: transactionData.businessId || this.businessId,
     });
-    return this._post('/api/v1/transactions', payload);
+    return this._post('/api/v1/transactions/create', payload);
   }
 
   /**
@@ -450,11 +449,11 @@ class KuvarPayServer {
 
   /**
    * Cancel a subscription (confirm cancellation)
-   * POST {Payment API Base}/api/v1/subscriptions/{subscriptionId}/cancel
+   * POST {Payment API Base}/api/v1/subscriptions/{subscriptionId}/cancel/confirm
    */
   async cancelSubscription(subscriptionId, body = {}) {
     if (!subscriptionId) throw new Error('subscriptionId is required');
-    return this._post(`/api/v1/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`, body);
+    return this._post(`/api/v1/subscriptions/${encodeURIComponent(subscriptionId)}/cancel/confirm`, body);
   }
 
   /**
@@ -464,14 +463,12 @@ class KuvarPayServer {
     return this._post('/api/v1/subscriptions/relay/authorizations', body);
   }
 
-  async getRelayAuthorizationStatus(body) {
-    return this._post('/api/v1/subscriptions/relay/authorization-status', body);
+  async getRelayAuthorizationStatus(subscriptionId) {
+    return this._get(`/api/v1/subscriptions/relay/authorizations/${encodeURIComponent(subscriptionId)}/status`);
   }
 
   async revokeRelayAuthorization(body) {
-    // Some environments use '/relay/revokeAuth'; support both via path param
-    const path = body?.useLegacyPath ? '/api/v1/subscriptions/relay/revokeAuth' : '/api/v1/subscriptions/revoke-authorization';
-    return this._post(path, body);
+    return this._post('/api/v1/subscriptions/relay/revokeAuth', body);
   }
 
   /**

package/index.mjs

@@ -8,10 +8,10 @@
 
 import crypto from 'node:crypto';
 
-const DEFAULT_BASE = (process.env.PAYMENT_API_BASE_URL
-  || process.env.PAYMENT_SERVER_URL
-  || process.env.NEXT_PUBLIC_PAYMENT_API_BASE_URL
-  || 'http://localhost:3002').replace(/\/+$/, '');
+const DEFAULT_BASE = (process.env.KUVARPAY_API_BASE_URL
+  || process.env.PAYMENT_API_BASE_URL
+  || 'https://payment.kuvarpay.com'
+).replace(/\/$/, '');
 
 export class KuvarPayServer {
   /**
@@ -37,7 +37,6 @@ export class KuvarPayServer {
   _headers(extra = {}) {
     return Object.assign({
       'Accept': 'application/json',
-      'Authorization': this.secretApiKey,
       'X-API-Key': this.secretApiKey,
       'X-Business-ID': this.businessId,
     }, extra);
@@ -140,14 +139,6 @@ export class KuvarPayServer {
     return this._get(path);
   }
 
-  async refundTransaction(transactionId, data = {}) {
-    return this._post(`/api/v1/transactions/${encodeURIComponent(transactionId)}/refund`, data);
-  }
-
-  async getExpiredTransactions() {
-    return this._get('/api/v1/transactions/expired');
-  }
-
   async getOptimalTransferFee(amount, currency = 'NGN') {
     return this._get(`/api/v1/optimal-transfer-fee?amount=${amount}&currency=${currency}`);
   }
@@ -193,7 +184,7 @@ export class KuvarPayServer {
     const payload = Object.assign({}, transactionData, {
       businessId: transactionData.businessId || this.businessId,
     });
-    return this._post('/api/v1/transactions', payload);
+    return this._post('/api/v1/transactions/create', payload);
   }
 
   async sendInvoiceEmail(sessionId) {
@@ -318,20 +309,19 @@ export class KuvarPayServer {
 
   async cancelSubscription(subscriptionId, body = {}) {
     if (!subscriptionId) throw new Error('subscriptionId is required');
-    return this._post(`/api/v1/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`, body);
+    return this._post(`/api/v1/subscriptions/${encodeURIComponent(subscriptionId)}/cancel/confirm`, body);
   }
 
   async createRelayAuthorization(body) {
     return this._post('/api/v1/subscriptions/relay/authorizations', body);
   }
 
-  async getRelayAuthorizationStatus(body) {
-    return this._post('/api/v1/subscriptions/relay/authorization-status', body);
+  async getRelayAuthorizationStatus(subscriptionId) {
+    return this._get(`/api/v1/subscriptions/relay/authorizations/${encodeURIComponent(subscriptionId)}/status`);
   }
 
   async revokeRelayAuthorization(body) {
-    const path = body?.useLegacyPath ? '/api/v1/subscriptions/relay/revokeAuth' : '/api/v1/subscriptions/revoke-authorization';
-    return this._post(path, body);
+    return this._post('/api/v1/subscriptions/relay/revokeAuth', body);
   }
 
   async createRenewalCheckoutSession(body) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuvarpay/sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Official KuvarPay Server SDK for Node.js",
   "main": "index.js",
   "module": "index.mjs",
@@ -27,4 +27,4 @@
   },
   "author": "KuvarPay Team",
   "license": "MIT"
-}
+}