@naturalpay/sdk 1.6.32 → 1.6.34

package/README.md

@@ -887,7 +887,7 @@ for await (const item of pageableResponse) {
 // Or you can manually iterate page-by-page
 let page = await client.agents.list();
 while (page.hasNextPage()) {
-    page = page.getNextPage();
+    page = await page.getNextPage();
 }
 
 // You can also access the underlying response

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@naturalpay/sdk",
-        "X-Fern-SDK-Version": "1.6.32",
-        "User-Agent": "@naturalpay/sdk/1.6.32",
+        "X-Fern-SDK-Version": "1.6.34",
+        "User-Agent": "@naturalpay/sdk/1.6.34",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
         "X-Instance-ID": options === null || options === void 0 ? void 0 : options.instanceId,

package/dist/cjs/Client.d.ts

@@ -1,5 +1,4 @@
 import { AchClient } from "./api/resources/ach/client/Client.js";
-import { AgentCardsClient } from "./api/resources/agentCards/client/Client.js";
 import { AgenticPaymentsClient } from "./api/resources/agenticPayments/client/Client.js";
 import { AgentKeysClient } from "./api/resources/agentKeys/client/Client.js";
 import { AgentsClient } from "./api/resources/agents/client/Client.js";
@@ -7,7 +6,6 @@ import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.js";
 import { ApprovalsClient } from "./api/resources/approvals/client/Client.js";
 import { CardPaymentsClient } from "./api/resources/cardPayments/client/Client.js";
 import { CardSessionsClient } from "./api/resources/cardSessions/client/Client.js";
-import { CardTransactionsClient } from "./api/resources/cardTransactions/client/Client.js";
 import { ChargebacksClient } from "./api/resources/chargebacks/client/Client.js";
 import { CustomersClient } from "./api/resources/customers/client/Client.js";
 import { EventsClient } from "./api/resources/events/client/Client.js";
@@ -65,8 +63,6 @@ export declare class NaturalClient {
     protected _agentKeys: AgentKeysClient | undefined;
     protected _cardSessions: CardSessionsClient | undefined;
     protected _agenticPayments: AgenticPaymentsClient | undefined;
-    protected _agentCards: AgentCardsClient | undefined;
-    protected _cardTransactions: CardTransactionsClient | undefined;
     protected _webhooks: WebhooksClient | undefined;
     protected _events: EventsClient | undefined;
     protected _simulations: SimulationsClient | undefined;
@@ -97,8 +93,6 @@ export declare class NaturalClient {
     get agentKeys(): AgentKeysClient;
     get cardSessions(): CardSessionsClient;
     get agenticPayments(): AgenticPaymentsClient;
-    get agentCards(): AgentCardsClient;
-    get cardTransactions(): CardTransactionsClient;
     get webhooks(): WebhooksClient;
     get events(): EventsClient;
     get simulations(): SimulationsClient;

package/dist/cjs/Client.js

@@ -45,36 +45,34 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NaturalClient = void 0;
 const Client_js_1 = require("./api/resources/ach/client/Client.js");
-const Client_js_2 = require("./api/resources/agentCards/client/Client.js");
-const Client_js_3 = require("./api/resources/agenticPayments/client/Client.js");
-const Client_js_4 = require("./api/resources/agentKeys/client/Client.js");
-const Client_js_5 = require("./api/resources/agents/client/Client.js");
-const Client_js_6 = require("./api/resources/apiKeys/client/Client.js");
-const Client_js_7 = require("./api/resources/approvals/client/Client.js");
-const Client_js_8 = require("./api/resources/cardPayments/client/Client.js");
-const Client_js_9 = require("./api/resources/cardSessions/client/Client.js");
-const Client_js_10 = require("./api/resources/cardTransactions/client/Client.js");
-const Client_js_11 = require("./api/resources/chargebacks/client/Client.js");
-const Client_js_12 = require("./api/resources/customers/client/Client.js");
-const Client_js_13 = require("./api/resources/events/client/Client.js");
-const Client_js_14 = require("./api/resources/externalAccounts/client/Client.js");
-const Client_js_15 = require("./api/resources/externalParties/client/Client.js");
-const Client_js_16 = require("./api/resources/externalPartyAccounts/client/Client.js");
-const Client_js_17 = require("./api/resources/invitationLinks/client/Client.js");
-const Client_js_18 = require("./api/resources/invitations/client/Client.js");
-const Client_js_19 = require("./api/resources/parties/client/Client.js");
-const Client_js_20 = require("./api/resources/paymentIntents/client/Client.js");
-const Client_js_21 = require("./api/resources/paymentRequests/client/Client.js");
-const Client_js_22 = require("./api/resources/payments/client/Client.js");
-const Client_js_23 = require("./api/resources/realtime/client/Client.js");
-const Client_js_24 = require("./api/resources/refunds/client/Client.js");
-const Client_js_25 = require("./api/resources/simulations/client/Client.js");
-const Client_js_26 = require("./api/resources/transactions/client/Client.js");
-const Client_js_27 = require("./api/resources/transfers/client/Client.js");
-const Client_js_28 = require("./api/resources/voiceSessions/client/Client.js");
-const Client_js_29 = require("./api/resources/wallets/client/Client.js");
-const Client_js_30 = require("./api/resources/webhooks/client/Client.js");
-const Client_js_31 = require("./api/resources/wire/client/Client.js");
+const Client_js_2 = require("./api/resources/agenticPayments/client/Client.js");
+const Client_js_3 = require("./api/resources/agentKeys/client/Client.js");
+const Client_js_4 = require("./api/resources/agents/client/Client.js");
+const Client_js_5 = require("./api/resources/apiKeys/client/Client.js");
+const Client_js_6 = require("./api/resources/approvals/client/Client.js");
+const Client_js_7 = require("./api/resources/cardPayments/client/Client.js");
+const Client_js_8 = require("./api/resources/cardSessions/client/Client.js");
+const Client_js_9 = require("./api/resources/chargebacks/client/Client.js");
+const Client_js_10 = require("./api/resources/customers/client/Client.js");
+const Client_js_11 = require("./api/resources/events/client/Client.js");
+const Client_js_12 = require("./api/resources/externalAccounts/client/Client.js");
+const Client_js_13 = require("./api/resources/externalParties/client/Client.js");
+const Client_js_14 = require("./api/resources/externalPartyAccounts/client/Client.js");
+const Client_js_15 = require("./api/resources/invitationLinks/client/Client.js");
+const Client_js_16 = require("./api/resources/invitations/client/Client.js");
+const Client_js_17 = require("./api/resources/parties/client/Client.js");
+const Client_js_18 = require("./api/resources/paymentIntents/client/Client.js");
+const Client_js_19 = require("./api/resources/paymentRequests/client/Client.js");
+const Client_js_20 = require("./api/resources/payments/client/Client.js");
+const Client_js_21 = require("./api/resources/realtime/client/Client.js");
+const Client_js_22 = require("./api/resources/refunds/client/Client.js");
+const Client_js_23 = require("./api/resources/simulations/client/Client.js");
+const Client_js_24 = require("./api/resources/transactions/client/Client.js");
+const Client_js_25 = require("./api/resources/transfers/client/Client.js");
+const Client_js_26 = require("./api/resources/voiceSessions/client/Client.js");
+const Client_js_27 = require("./api/resources/wallets/client/Client.js");
+const Client_js_28 = require("./api/resources/webhooks/client/Client.js");
+const Client_js_29 = require("./api/resources/wire/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class NaturalClient {
@@ -83,27 +81,27 @@ class NaturalClient {
     }
     get agents() {
         var _a;
-        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_5.AgentsClient(this._options)));
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_4.AgentsClient(this._options)));
     }
     get customers() {
         var _a;
-        return ((_a = this._customers) !== null && _a !== void 0 ? _a : (this._customers = new Client_js_12.CustomersClient(this._options)));
+        return ((_a = this._customers) !== null && _a !== void 0 ? _a : (this._customers = new Client_js_10.CustomersClient(this._options)));
     }
     get invitationLinks() {
         var _a;
-        return ((_a = this._invitationLinks) !== null && _a !== void 0 ? _a : (this._invitationLinks = new Client_js_17.InvitationLinksClient(this._options)));
+        return ((_a = this._invitationLinks) !== null && _a !== void 0 ? _a : (this._invitationLinks = new Client_js_15.InvitationLinksClient(this._options)));
     }
     get payments() {
         var _a;
-        return ((_a = this._payments) !== null && _a !== void 0 ? _a : (this._payments = new Client_js_22.PaymentsClient(this._options)));
+        return ((_a = this._payments) !== null && _a !== void 0 ? _a : (this._payments = new Client_js_20.PaymentsClient(this._options)));
     }
     get externalParties() {
         var _a;
-        return ((_a = this._externalParties) !== null && _a !== void 0 ? _a : (this._externalParties = new Client_js_15.ExternalPartiesClient(this._options)));
+        return ((_a = this._externalParties) !== null && _a !== void 0 ? _a : (this._externalParties = new Client_js_13.ExternalPartiesClient(this._options)));
     }
     get externalPartyAccounts() {
         var _a;
-        return ((_a = this._externalPartyAccounts) !== null && _a !== void 0 ? _a : (this._externalPartyAccounts = new Client_js_16.ExternalPartyAccountsClient(this._options)));
+        return ((_a = this._externalPartyAccounts) !== null && _a !== void 0 ? _a : (this._externalPartyAccounts = new Client_js_14.ExternalPartyAccountsClient(this._options)));
     }
     get ach() {
         var _a;
@@ -111,99 +109,91 @@ class NaturalClient {
     }
     get realtime() {
         var _a;
-        return ((_a = this._realtime) !== null && _a !== void 0 ? _a : (this._realtime = new Client_js_23.RealtimeClient(this._options)));
+        return ((_a = this._realtime) !== null && _a !== void 0 ? _a : (this._realtime = new Client_js_21.RealtimeClient(this._options)));
     }
     get wire() {
         var _a;
-        return ((_a = this._wire) !== null && _a !== void 0 ? _a : (this._wire = new Client_js_31.WireClient(this._options)));
+        return ((_a = this._wire) !== null && _a !== void 0 ? _a : (this._wire = new Client_js_29.WireClient(this._options)));
     }
     get paymentIntents() {
         var _a;
-        return ((_a = this._paymentIntents) !== null && _a !== void 0 ? _a : (this._paymentIntents = new Client_js_20.PaymentIntentsClient(this._options)));
+        return ((_a = this._paymentIntents) !== null && _a !== void 0 ? _a : (this._paymentIntents = new Client_js_18.PaymentIntentsClient(this._options)));
     }
     get cardPayments() {
         var _a;
-        return ((_a = this._cardPayments) !== null && _a !== void 0 ? _a : (this._cardPayments = new Client_js_8.CardPaymentsClient(this._options)));
+        return ((_a = this._cardPayments) !== null && _a !== void 0 ? _a : (this._cardPayments = new Client_js_7.CardPaymentsClient(this._options)));
     }
     get voiceSessions() {
         var _a;
-        return ((_a = this._voiceSessions) !== null && _a !== void 0 ? _a : (this._voiceSessions = new Client_js_28.VoiceSessionsClient(this._options)));
+        return ((_a = this._voiceSessions) !== null && _a !== void 0 ? _a : (this._voiceSessions = new Client_js_26.VoiceSessionsClient(this._options)));
     }
     get refunds() {
         var _a;
-        return ((_a = this._refunds) !== null && _a !== void 0 ? _a : (this._refunds = new Client_js_24.RefundsClient(this._options)));
+        return ((_a = this._refunds) !== null && _a !== void 0 ? _a : (this._refunds = new Client_js_22.RefundsClient(this._options)));
     }
     get chargebacks() {
         var _a;
-        return ((_a = this._chargebacks) !== null && _a !== void 0 ? _a : (this._chargebacks = new Client_js_11.ChargebacksClient(this._options)));
+        return ((_a = this._chargebacks) !== null && _a !== void 0 ? _a : (this._chargebacks = new Client_js_9.ChargebacksClient(this._options)));
     }
     get transactions() {
         var _a;
-        return ((_a = this._transactions) !== null && _a !== void 0 ? _a : (this._transactions = new Client_js_26.TransactionsClient(this._options)));
+        return ((_a = this._transactions) !== null && _a !== void 0 ? _a : (this._transactions = new Client_js_24.TransactionsClient(this._options)));
     }
     get transfers() {
         var _a;
-        return ((_a = this._transfers) !== null && _a !== void 0 ? _a : (this._transfers = new Client_js_27.TransfersClient(this._options)));
+        return ((_a = this._transfers) !== null && _a !== void 0 ? _a : (this._transfers = new Client_js_25.TransfersClient(this._options)));
     }
     get paymentRequests() {
         var _a;
-        return ((_a = this._paymentRequests) !== null && _a !== void 0 ? _a : (this._paymentRequests = new Client_js_21.PaymentRequestsClient(this._options)));
+        return ((_a = this._paymentRequests) !== null && _a !== void 0 ? _a : (this._paymentRequests = new Client_js_19.PaymentRequestsClient(this._options)));
     }
     get approvals() {
         var _a;
-        return ((_a = this._approvals) !== null && _a !== void 0 ? _a : (this._approvals = new Client_js_7.ApprovalsClient(this._options)));
+        return ((_a = this._approvals) !== null && _a !== void 0 ? _a : (this._approvals = new Client_js_6.ApprovalsClient(this._options)));
     }
     get invitations() {
         var _a;
-        return ((_a = this._invitations) !== null && _a !== void 0 ? _a : (this._invitations = new Client_js_18.InvitationsClient(this._options)));
+        return ((_a = this._invitations) !== null && _a !== void 0 ? _a : (this._invitations = new Client_js_16.InvitationsClient(this._options)));
     }
     get parties() {
         var _a;
-        return ((_a = this._parties) !== null && _a !== void 0 ? _a : (this._parties = new Client_js_19.PartiesClient(this._options)));
+        return ((_a = this._parties) !== null && _a !== void 0 ? _a : (this._parties = new Client_js_17.PartiesClient(this._options)));
     }
     get wallets() {
         var _a;
-        return ((_a = this._wallets) !== null && _a !== void 0 ? _a : (this._wallets = new Client_js_29.WalletsClient(this._options)));
+        return ((_a = this._wallets) !== null && _a !== void 0 ? _a : (this._wallets = new Client_js_27.WalletsClient(this._options)));
     }
     get externalAccounts() {
         var _a;
-        return ((_a = this._externalAccounts) !== null && _a !== void 0 ? _a : (this._externalAccounts = new Client_js_14.ExternalAccountsClient(this._options)));
+        return ((_a = this._externalAccounts) !== null && _a !== void 0 ? _a : (this._externalAccounts = new Client_js_12.ExternalAccountsClient(this._options)));
     }
     get apiKeys() {
         var _a;
-        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_6.ApiKeysClient(this._options)));
+        return ((_a = this._apiKeys) !== null && _a !== void 0 ? _a : (this._apiKeys = new Client_js_5.ApiKeysClient(this._options)));
     }
     get agentKeys() {
         var _a;
-        return ((_a = this._agentKeys) !== null && _a !== void 0 ? _a : (this._agentKeys = new Client_js_4.AgentKeysClient(this._options)));
+        return ((_a = this._agentKeys) !== null && _a !== void 0 ? _a : (this._agentKeys = new Client_js_3.AgentKeysClient(this._options)));
     }
     get cardSessions() {
         var _a;
-        return ((_a = this._cardSessions) !== null && _a !== void 0 ? _a : (this._cardSessions = new Client_js_9.CardSessionsClient(this._options)));
+        return ((_a = this._cardSessions) !== null && _a !== void 0 ? _a : (this._cardSessions = new Client_js_8.CardSessionsClient(this._options)));
     }
     get agenticPayments() {
         var _a;
-        return ((_a = this._agenticPayments) !== null && _a !== void 0 ? _a : (this._agenticPayments = new Client_js_3.AgenticPaymentsClient(this._options)));
-    }
-    get agentCards() {
-        var _a;
-        return ((_a = this._agentCards) !== null && _a !== void 0 ? _a : (this._agentCards = new Client_js_2.AgentCardsClient(this._options)));
-    }
-    get cardTransactions() {
-        var _a;
-        return ((_a = this._cardTransactions) !== null && _a !== void 0 ? _a : (this._cardTransactions = new Client_js_10.CardTransactionsClient(this._options)));
+        return ((_a = this._agenticPayments) !== null && _a !== void 0 ? _a : (this._agenticPayments = new Client_js_2.AgenticPaymentsClient(this._options)));
     }
     get webhooks() {
         var _a;
-        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_30.WebhooksClient(this._options)));
+        return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new Client_js_28.WebhooksClient(this._options)));
     }
     get events() {
         var _a;
-        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_js_13.EventsClient(this._options)));
+        return ((_a = this._events) !== null && _a !== void 0 ? _a : (this._events = new Client_js_11.EventsClient(this._options)));
     }
     get simulations() {
         var _a;
-        return ((_a = this._simulations) !== null && _a !== void 0 ? _a : (this._simulations = new Client_js_25.SimulationsClient(this._options)));
+        return ((_a = this._simulations) !== null && _a !== void 0 ? _a : (this._simulations = new Client_js_23.SimulationsClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

package/dist/cjs/api/resources/ach/client/requests/CancelAchParams.d.ts

@@ -7,6 +7,7 @@
  *     }
  */
 export interface CancelAchParams {
+    /** ACH payment ID (ach_*). */
     achId: string;
     /** Unique key for safely retrying a request without creating duplicates. */
     idempotencyKey: string;

package/dist/cjs/api/resources/ach/client/requests/GetAchRequest.d.ts

@@ -5,6 +5,8 @@
  *     }
  */
 export interface GetAchRequest {
+    /** ACH payment ID (ach_*). */
     achId: string;
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
 }

package/dist/cjs/api/resources/ach/client/requests/ListAchRequest.d.ts

@@ -4,11 +4,18 @@ import type * as Natural from "../../../../index.js";
  *     {}
  */
 export interface ListAchRequest {
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
+    /** Filter by status. */
     status?: Natural.ListAchRequestStatus;
+    /** Filter by direction. */
     direction?: Natural.ListAchRequestDirection;
+    /** Only payments to this external party (epty_*). */
     externalPartyId?: string;
+    /** Only payments using this account (epa_*). */
     externalPartyAccountId?: string;
+    /** Maximum results per page. */
     limit?: number;
+    /** Cursor from the previous page. */
     cursor?: string;
 }

package/dist/cjs/api/resources/agentKeys/client/requests/ListAgentKeysRequest.d.ts

@@ -3,7 +3,10 @@
  *     {}
  */
 export interface ListAgentKeysRequest {
+    /** Filter to keys bound to this agent (agt_*). */
     agentId?: string;
+    /** Cursor from the previous page. */
     cursor?: string;
+    /** Maximum results per page. */
     limit?: number;
 }

package/dist/cjs/api/resources/agentKeys/client/requests/RevokeAgentKeysRequest.d.ts

@@ -6,6 +6,7 @@
  *     }
  */
 export interface RevokeAgentKeysRequest {
+    /** Agent key ID (agk_*). */
     keyId: string;
     /** Unique key for safely retrying a request without creating duplicates. */
     idempotencyKey: string;

package/dist/cjs/api/resources/agentKeys/client/requests/RotateAgentKeysRequest.d.ts

@@ -10,6 +10,7 @@
  *     }
  */
 export interface RotateAgentKeysRequest {
+    /** Agent key ID (agk_*). */
     keyId: string;
     /** Unique key for safely retrying a request without creating duplicates. */
     idempotencyKey: string;

package/dist/cjs/api/resources/agenticPayments/client/Client.d.ts

@@ -10,6 +10,34 @@ export declare namespace AgenticPaymentsClient {
 export declare class AgenticPaymentsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AgenticPaymentsClient.Options>;
     constructor(options?: AgenticPaymentsClient.Options);
+    /**
+     * Get enrollment and mandates for a saved card. An agent sees only the mandates it can spend under.
+     *
+     * @param {Natural.CardAgenticPaymentsRequest} request
+     * @param {AgenticPaymentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Natural.BadRequestError}
+     * @throws {@link Natural.UnauthorizedError}
+     * @throws {@link Natural.ForbiddenError}
+     * @throws {@link Natural.NotFoundError}
+     * @throws {@link Natural.ConflictError}
+     * @throws {@link Natural.UnprocessableEntityError}
+     * @throws {@link Natural.PreconditionError}
+     * @throws {@link Natural.TooManyRequestsError}
+     * @throws {@link Natural.InternalServerError}
+     * @throws {@link Natural.NotImplementedError}
+     * @throws {@link Natural.BadGatewayError}
+     * @throws {@link Natural.ServiceUnavailableError}
+     * @throws {@link errors.NaturalError}
+     * @throws {@link errors.NaturalTimeoutError}
+     *
+     * @example
+     *     await client.agenticPayments.card({
+     *         cardId: "cardId"
+     *     })
+     */
+    card(request: Natural.CardAgenticPaymentsRequest, requestOptions?: AgenticPaymentsClient.RequestOptions): core.HttpResponsePromise<Natural.CardAgenticPaymentsResponse>;
+    private __card;
     /**
      * List the party's usable mandates for the calling agent, or all of the owner's mandates
      *

package/dist/cjs/api/resources/agenticPayments/client/Client.js

@@ -68,6 +68,114 @@ class AgenticPaymentsClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
+    /**
+     * Get enrollment and mandates for a saved card. An agent sees only the mandates it can spend under.
+     *
+     * @param {Natural.CardAgenticPaymentsRequest} request
+     * @param {AgenticPaymentsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Natural.BadRequestError}
+     * @throws {@link Natural.UnauthorizedError}
+     * @throws {@link Natural.ForbiddenError}
+     * @throws {@link Natural.NotFoundError}
+     * @throws {@link Natural.ConflictError}
+     * @throws {@link Natural.UnprocessableEntityError}
+     * @throws {@link Natural.PreconditionError}
+     * @throws {@link Natural.TooManyRequestsError}
+     * @throws {@link Natural.InternalServerError}
+     * @throws {@link Natural.NotImplementedError}
+     * @throws {@link Natural.BadGatewayError}
+     * @throws {@link Natural.ServiceUnavailableError}
+     * @throws {@link errors.NaturalError}
+     * @throws {@link errors.NaturalTimeoutError}
+     *
+     * @example
+     *     await client.agenticPayments.card({
+     *         cardId: "cardId"
+     *     })
+     */
+    card(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__card(request, requestOptions));
+    }
+    __card(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+            const { cardId, provider, customerPartyId } = request;
+            const _queryParams = {
+                provider: provider != null
+                    ? serializers.CardAgenticPaymentsRequestProvider.jsonOrThrow(provider, {
+                        unrecognizedObjectKeys: "strip",
+                        omitUndefined: true,
+                    })
+                    : undefined,
+                customerPartyId,
+            };
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ "X-Instance-ID": (_b = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.instanceId) !== null && _b !== void 0 ? _b : (_c = this._options) === null || _c === void 0 ? void 0 : _c.instanceId }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_d = this._options.fetcher) !== null && _d !== void 0 ? _d : core.fetcher)({
+                url: core.url.join((_f = (_e = (yield core.Supplier.get(this._options.baseUrl))) !== null && _e !== void 0 ? _e : (yield core.Supplier.get(this._options.environment))) !== null && _f !== void 0 ? _f : environments.NaturalEnvironment.Production, `agentic-payments/cards/${core.url.encodePathParam(cardId)}`),
+                method: "GET",
+                headers: _headers,
+                queryString: core.url
+                    .queryBuilder()
+                    .addMany(_queryParams)
+                    .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                    .build(),
+                timeoutMs: ((_j = (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.timeoutInSeconds) !== null && _j !== void 0 ? _j : 60) * 1000,
+                maxRetries: (_k = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _k !== void 0 ? _k : (_l = this._options) === null || _l === void 0 ? void 0 : _l.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_m = this._options) === null || _m === void 0 ? void 0 : _m.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.CardAgenticPaymentsResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Natural.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Natural.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 403:
+                        throw new Natural.ForbiddenError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new Natural.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new Natural.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new Natural.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 428:
+                        throw new Natural.PreconditionError(_response.error.body, _response.rawResponse);
+                    case 429:
+                        throw new Natural.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Natural.InternalServerError(_response.error.body, _response.rawResponse);
+                    case 501:
+                        throw new Natural.NotImplementedError(_response.error.body, _response.rawResponse);
+                    case 502:
+                        throw new Natural.BadGatewayError(_response.error.body, _response.rawResponse);
+                    case 503:
+                        throw new Natural.ServiceUnavailableError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.NaturalError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/agentic-payments/cards/{cardId}");
+        });
+    }
     /**
      * List the party's usable mandates for the calling agent, or all of the owner's mandates
      *

package/dist/cjs/api/resources/agenticPayments/client/requests/CancelPurchaseAgenticPaymentsRequest.d.ts

@@ -5,6 +5,8 @@
  *     }
  */
 export interface CancelPurchaseAgenticPaymentsRequest {
+    /** Purchase ID (apu_*). */
     purchaseId: string;
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
 }

package/dist/cjs/api/resources/agenticPayments/client/requests/CardAgenticPaymentsRequest.d.ts

@@ -0,0 +1,15 @@
+import type * as Natural from "../../../../index.js";
+/**
+ * @example
+ *     {
+ *         cardId: "cardId"
+ *     }
+ */
+export interface CardAgenticPaymentsRequest {
+    /** Saved card ID (eac_*). */
+    cardId: string;
+    /** Payment method provider. */
+    provider?: Natural.CardAgenticPaymentsRequestProvider;
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
+    customerPartyId?: string;
+}

package/dist/cjs/api/resources/agenticPayments/client/requests/ClaimPurchaseAgenticPaymentsRequest.d.ts

@@ -5,6 +5,8 @@
  *     }
  */
 export interface ClaimPurchaseAgenticPaymentsRequest {
+    /** Purchase ID (apu_*). */
     purchaseId: string;
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
 }

package/dist/cjs/api/resources/agenticPayments/client/requests/GetMandateAgenticPaymentsRequest.d.ts

@@ -5,6 +5,8 @@
  *     }
  */
 export interface GetMandateAgenticPaymentsRequest {
+    /** Mandate ID (amd_*). */
     mandateId: string;
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
 }

package/dist/cjs/api/resources/agenticPayments/client/requests/GetPurchaseAgenticPaymentsRequest.d.ts

@@ -5,6 +5,8 @@
  *     }
  */
 export interface GetPurchaseAgenticPaymentsRequest {
+    /** Purchase ID (apu_*). */
     purchaseId: string;
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
 }

package/dist/cjs/api/resources/agenticPayments/client/requests/ListMandatesAgenticPaymentsRequest.d.ts

@@ -3,7 +3,10 @@
  *     {}
  */
 export interface ListMandatesAgenticPaymentsRequest {
+    /** Customer party to act for (pty_*). Omit to act as your own party. To act for another party, pass the ID of a party that has authorized you to act on its behalf. */
     customerPartyId?: string;
+    /** Maximum results per page. */
     limit?: number;
+    /** Cursor from the previous page. */
     cursor?: string;
 }

package/dist/cjs/api/resources/agenticPayments/client/requests/index.d.ts

@@ -1,4 +1,5 @@
 export type { CancelPurchaseAgenticPaymentsRequest } from "./CancelPurchaseAgenticPaymentsRequest.js";
+export type { CardAgenticPaymentsRequest } from "./CardAgenticPaymentsRequest.js";
 export type { ClaimPurchaseAgenticPaymentsRequest } from "./ClaimPurchaseAgenticPaymentsRequest.js";
 export type { CreatePurchaseAgenticPaymentsRequest } from "./CreatePurchaseAgenticPaymentsRequest.js";
 export type { GetMandateAgenticPaymentsRequest } from "./GetMandateAgenticPaymentsRequest.js";

package/dist/cjs/api/resources/agenticPayments/types/CardAgenticPaymentsRequestProvider.d.ts

@@ -0,0 +1,6 @@
+/** Payment method provider. */
+export declare const CardAgenticPaymentsRequestProvider: {
+    readonly BasisTheory: "basis_theory";
+    readonly Simulation: "simulation";
+};
+export type CardAgenticPaymentsRequestProvider = (typeof CardAgenticPaymentsRequestProvider)[keyof typeof CardAgenticPaymentsRequestProvider];

package/dist/cjs/api/resources/agenticPayments/types/CardAgenticPaymentsRequestProvider.js

@@ -0,0 +1,9 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CardAgenticPaymentsRequestProvider = void 0;
+/** Payment method provider. */
+exports.CardAgenticPaymentsRequestProvider = {
+    BasisTheory: "basis_theory",
+    Simulation: "simulation",
+};

package/dist/cjs/api/resources/agenticPayments/types/CardAgenticPaymentsResponse.d.ts

@@ -0,0 +1,4 @@
+import type * as Natural from "../../../index.js";
+export interface CardAgenticPaymentsResponse {
+    data: Natural.CardAgenticPaymentsResponseData;
+}

package/dist/cjs/api/resources/agenticPayments/types/CardAgenticPaymentsResponseData.d.ts

@@ -0,0 +1,7 @@
+import type * as Natural from "../../../index.js";
+export interface CardAgenticPaymentsResponseData {
+    enabled: boolean;
+    simulated: boolean;
+    paymentMethod: Natural.CardAgenticPaymentsResponseDataPaymentMethod | null;
+    mandates: Natural.CardAgenticPaymentsResponseDataMandatesItem[];
+}

package/dist/cjs/api/resources/agenticPayments/types/CardAgenticPaymentsResponseDataMandatesItem.d.ts

@@ -0,0 +1,17 @@
+import type * as Natural from "../../../index.js";
+export interface CardAgenticPaymentsResponseDataMandatesItem {
+    id: string;
+    paymentMethodId: string;
+    provider: Natural.CardAgenticPaymentsResponseDataMandatesItemProvider;
+    /** The agent reading this mandate. Mandates belong to the card and every agent with access to the card spends under them; null when the card owner reads one. */
+    agentId: string | null;
+    status: Natural.CardAgenticPaymentsResponseDataMandatesItemStatus;
+    amount: number;
+    available: number;
+    perPurchaseLimit: number;
+    currency: Natural.CardAgenticPaymentsResponseDataMandatesItemCurrency;
+    description: string;
+    expiresAt: Date;
+    merchantScope: Natural.CardAgenticPaymentsResponseDataMandatesItemMerchantScope;
+    errorCode: string | null;
+}