@kuvarpay/sdk 1.5.0 → 1.6.0

package/README.md

@@ -96,7 +96,7 @@ The SDK defaults to the KuvarPay Production API (`https://payment.kuvarpay.com`)
 | Method | Description |
 | :--- | :--- |
 | `getBanks({ country? \| currency?, type? })` | List a corridor's **primary-rail** payment methods (banks / mobile money). Pass a country (ISO-2) or currency (ISO-4217). |
-| `resolveBankAccount(data)` | Verify bank account names before creating subaccounts. |
+| `resolveBankAccount(data)` | **Deprecated** alias for `resolveRecipient` — takes `methodId`, not `bank_code`. |
 
 ### 🌍 Fiat Collection (Pay with Local Currency)
 

package/index.d.ts

@@ -236,7 +236,30 @@ export class KuvarPayServer {
   // Banks
   getBanks(currency: string, options?: { type?: 'bank' | 'mobile_money'; direction?: 'inbound' | 'outbound' }): Promise<{ methods: Array<{ methodId: string; name: string; currency: string; type: 'bank' | 'mobile_money'; manualInput?: boolean; minAmount?: number | null; maxAmount?: number | null }> }>;
   getBanks(params: { country?: string; currency?: string; type?: 'bank' | 'mobile_money'; direction?: 'inbound' | 'outbound' }): Promise<{ methods: Array<{ methodId: string; name: string; currency: string; type: 'bank' | 'mobile_money'; manualInput?: boolean; minAmount?: number | null; maxAmount?: number | null }> }>;
-  resolveBankAccount(data: { bank_code: string; account_number: string; country_code?: string }): Promise<any>;
+  /**
+   * @deprecated Use `resolveRecipient`. Thin alias over
+   * `POST /api/v1/fiat/resolve-recipient`.
+   *
+   * The legacy `/api/v1/banks/resolve` endpoint was retired; passing `bank_code`
+   * now throws. Supply `methodId` from `getBanks({ direction: 'outbound' })`.
+   */
+  resolveBankAccount(data: {
+    methodId?: string;
+    method_id?: string;
+    accountNumber?: string;
+    account_number?: string;
+    phone?: string;
+  }): Promise<{
+    supported: boolean;
+    resolved: boolean;
+    accountName: string | null;
+    bankName?: string;
+    reason?: string | null;
+    /** Legacy alias for `accountName`. */
+    account_name: string | null;
+    /** Echo of the submitted account number. */
+    account_number: string | null;
+  }>;
 
   // Fiat collection (Pay with Local Currency)
   /**

package/index.js

@@ -549,12 +549,37 @@ class KuvarPayServer {
   }
 
   /**
-   * Resolve bank account name
-   * POST /api/v1/banks/resolve
-   * @param {Object} data - { bank_code, account_number, country_code? }
+   * Resolve a bank / mobile-money account name.
+   *
+   * @deprecated Use {@link resolveRecipient}. Kept as a thin alias so existing
+   * integrations keep working.
+   *
+   * The legacy `POST /api/v1/banks/resolve` endpoint (which took a raw
+   * `bank_code`) has been retired — calling it now 404s. Name enquiry runs
+   * through `POST /api/v1/fiat/resolve-recipient`, which is keyed off the opaque
+   * `methodId` from `getBanks()`.
+   *
+   * @param {Object} data - { methodId | method_id, accountNumber | account_number, phone }
    */
-  async resolveBankAccount(data) {
-    return this._post('/api/v1/banks/resolve', data);
+  async resolveBankAccount(data = {}) {
+    const methodId = data.methodId || data.method_id;
+    const accountNumber = data.accountNumber || data.account_number;
+    const phone = data.phone;
+
+    if (!methodId) {
+      throw new Error(
+        (data.bank_code || data.bankCode)
+          ? 'resolveBankAccount no longer accepts bank_code — the legacy /api/v1/banks endpoints were retired. ' +
+            'Pass methodId from getBanks({ country, direction: "outbound" }) instead, or call resolveRecipient() directly.'
+          : 'methodId is required (get one from getBanks({ country, direction: "outbound" }))'
+      );
+    }
+
+    const result = await this.resolveRecipient({ methodId, accountNumber, phone });
+    return Object.assign({}, result, {
+      account_name: result && result.accountName != null ? result.accountName : null,
+      account_number: accountNumber != null ? accountNumber : null,
+    });
   }
 
   // --- Fiat collection (Pay with Local Currency) ---

package/index.mjs

@@ -436,8 +436,40 @@ export class KuvarPayServer {
     return this._get(`/api/v1/fiat/banks?${qs.toString()}`);
   }
 
-  async resolveBankAccount(data) {
-    return this._post('/api/v1/banks/resolve', data);
+  /**
+   * @deprecated Use {@link resolveRecipient}. Kept as a thin alias so existing
+   * integrations keep working.
+   *
+   * The legacy `POST /api/v1/banks/resolve` endpoint (which took a raw
+   * `bank_code`) has been retired — calling it now 404s. Name enquiry runs
+   * through `POST /api/v1/fiat/resolve-recipient`, which is keyed off the opaque
+   * `methodId` from `getBanks()`.
+   *
+   * Accepts either the new field names or the legacy snake_case ones:
+   *   { methodId | method_id, accountNumber | account_number, phone }
+   *
+   * Returns the resolveRecipient shape ({ supported, resolved, accountName, … })
+   * plus `account_name` / `account_number` aliases for older call sites.
+   */
+  async resolveBankAccount(data = {}) {
+    const methodId = data.methodId || data.method_id;
+    const accountNumber = data.accountNumber || data.account_number;
+    const phone = data.phone;
+
+    if (!methodId) {
+      throw new Error(
+        (data.bank_code || data.bankCode)
+          ? 'resolveBankAccount no longer accepts bank_code — the legacy /api/v1/banks endpoints were retired. ' +
+            'Pass methodId from getBanks({ country, direction: "outbound" }) instead, or call resolveRecipient() directly.'
+          : 'methodId is required (get one from getBanks({ country, direction: "outbound" }))'
+      );
+    }
+
+    const result = await this.resolveRecipient({ methodId, accountNumber, phone });
+    return Object.assign({}, result, {
+      account_name: result && result.accountName != null ? result.accountName : null,
+      account_number: accountNumber != null ? accountNumber : null,
+    });
   }
 
   // --- Fiat collection (Pay with Local Currency) ---

package/package.json

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