@thepayulink/server 2.2.0 → 2.2.1

package/README.md

@@ -75,6 +75,12 @@ toRupees(19950);  // 199.5
 
 ### Payouts
 
+Payouts, `balance.fetch()` and `transactions.list()` need a **live key with Payouts access**
+and an **IP allowlist** (merchant panel → API Key → *Edit access*). Otherwise the API
+answers `403 KEY_NOT_PERMITTED`, `403 IP_NOT_ALLOWED`, or `400 TEST_MODE_UNSUPPORTED` for a
+test key. Keep that key only on the server that sends payouts; use a separate Checkout key
+for orders.
+
 ```js
 const payout = await pl.payouts.create({
   amount: rupees(2500),                      // PAISE; UPI payouts must be whole rupees

package/dist/index.d.ts

@@ -172,6 +172,7 @@ export default class PayuLink {
     list(params?: ListParams & { status?: string; receipt?: string; utr?: string }): Promise<Collection<Order>>;
   };
 
+  /** Needs a live key with Payouts access, called from an IP on the key's allowlist. */
   payouts: {
     create(params: CreatePayoutParams): Promise<Payout>;
     fetch(payoutId: string): Promise<Payout>;
@@ -180,10 +181,12 @@ export default class PayuLink {
     cancel(payoutId: string, params?: { reason?: string }): Promise<Payout>;
   };
 
+  /** Needs a live key with Payouts access, called from an IP on the key's allowlist. */
   balance: {
     fetch(): Promise<Balance>;
   };
 
+  /** Needs a live key with Payouts access, called from an IP on the key's allowlist. */
   transactions: {
     /** type: comma-separated names, e.g. "payout_lock,payout_debit" */
     list(params?: ListParams & { type?: string }): Promise<Collection<Transaction>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thepayulink/server",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "PayuLink server SDK — create orders and verify payments/webhooks with your key_secret.",
   "type": "module",
   "main": "./dist/payulink-server.cjs",