@zendfi/sdk 1.1.5 → 1.1.7

package/README.md

@@ -301,6 +301,57 @@ For `withdrawFromSubAccount` and `withdrawSubAccountToBank`, the recommended hea
 
 Legacy direct mint (`createSubAccountSigningGrant` with `passkey_signature`) remains available as fallback.
 
+Example browser-intent flow (Node/CLI app):
+
+```typescript
+import open from 'open';
+import { zendfi } from '@zendfi/sdk';
+
+const intent = await zendfi.startSubAccountSigningGrantBrowserIntent({
+  sub_account_id: 'sa_7b1w9j2k4m8p',
+  ttl_seconds: 3600,
+  max_uses: 25,
+  total_limit_usdc: 500,
+  per_tx_limit_usdc: 50,
+  mode: 'live',
+});
+
+await open(intent.approval_url);
+
+let grant: string | undefined;
+for (let i = 0; i < 180; i += 1) {
+  const poll = await zendfi.pollSubAccountSigningGrantBrowserIntent({
+    intent_id: intent.intent_id,
+    intent_token: intent.intent_token,
+  });
+
+  if (poll.completed) {
+    if (poll.status !== 'approved' || !poll.grant) {
+      throw new Error(poll.error || `intent ended in ${poll.status}`);
+    }
+    grant = poll.grant.signing_grant;
+    break;
+  }
+
+  await new Promise((r) => setTimeout(r, 2000));
+}
+
+if (!grant) {
+  throw new Error('Timed out waiting for browser approval');
+}
+
+await zendfi.withdrawSubAccountToBank('sa_7b1w9j2k4m8p', {
+  amount_usdc: 25,
+  bank_id: 'GTB',
+  account_number: '0123456789',
+  mode: 'live',
+  automation_token: 'saatk_xxxxx',
+  signing_grant: grant,
+});
+```
+
+`bank_id` accepts PAJ bank id, bank code, or bank name.
+
 `withdrawSubAccountToBank` executes PAJ offramp with server-side proxy-email OTP automation (same pattern as split bank withdrawals), so your integration does not need to collect OTP manually.
 
 `passkey_signature` on `withdrawFromSubAccount` and `withdrawSubAccountToBank` is now optional and should be treated as interactive fallback.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zendfi/sdk",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "Zero-config TypeScript SDK for ZendFi. Global payments powered by stablecoins!",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",