@naturalpay/sdk 1.6.33 → 1.6.35

package/dist/cjs/serialization/resources/agenticPayments/types/index.js

@@ -22,6 +22,17 @@ __exportStar(require("./CancelPurchaseAgenticPaymentsResponseDataDelivery.js"),
 __exportStar(require("./CancelPurchaseAgenticPaymentsResponseDataMerchant.js"), exports);
 __exportStar(require("./CancelPurchaseAgenticPaymentsResponseDataProvider.js"), exports);
 __exportStar(require("./CancelPurchaseAgenticPaymentsResponseDataStatus.js"), exports);
+__exportStar(require("./CardAgenticPaymentsRequestProvider.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponse.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseData.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataMandatesItem.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataMandatesItemCurrency.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataMandatesItemMerchantScope.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataMandatesItemProvider.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataMandatesItemStatus.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataPaymentMethod.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataPaymentMethodProvider.js"), exports);
+__exportStar(require("./CardAgenticPaymentsResponseDataPaymentMethodStatus.js"), exports);
 __exportStar(require("./ClaimPurchaseAgenticPaymentsResponse.js"), exports);
 __exportStar(require("./ClaimPurchaseAgenticPaymentsResponseData.js"), exports);
 __exportStar(require("./ClaimPurchaseAgenticPaymentsResponseDataAgentToken.js"), exports);

package/dist/cjs/serialization/resources/agents/types/ListCustomersAgentsResponseDataItemAttributes.d.ts

@@ -8,6 +8,7 @@ export declare namespace ListCustomersAgentsResponseDataItemAttributes {
     interface Raw {
         name?: string | null;
         email?: string | null;
+        avatarUrl?: string | null;
         status: ListCustomersAgentsResponseDataItemAttributesStatus.Raw;
         permissions: string[];
         limits?: ListCustomersAgentsResponseDataItemAttributesLimits.Raw | null;

package/dist/cjs/serialization/resources/agents/types/ListCustomersAgentsResponseDataItemAttributes.js

@@ -41,6 +41,7 @@ const ListCustomersAgentsResponseDataItemAttributesStatus_js_1 = require("./List
 exports.ListCustomersAgentsResponseDataItemAttributes = core.serialization.object({
     name: core.serialization.string().nullable(),
     email: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
     status: ListCustomersAgentsResponseDataItemAttributesStatus_js_1.ListCustomersAgentsResponseDataItemAttributesStatus,
     permissions: core.serialization.list(core.serialization.string()),
     limits: ListCustomersAgentsResponseDataItemAttributesLimits_js_1.ListCustomersAgentsResponseDataItemAttributesLimits.nullable(),

package/dist/cjs/serialization/resources/agents/types/RemoveCustomerAgentsResponseDataAttributes.d.ts

@@ -8,6 +8,7 @@ export declare namespace RemoveCustomerAgentsResponseDataAttributes {
     interface Raw {
         name?: string | null;
         email?: string | null;
+        avatarUrl?: string | null;
         status: RemoveCustomerAgentsResponseDataAttributesStatus.Raw;
         permissions: string[];
         limits?: RemoveCustomerAgentsResponseDataAttributesLimits.Raw | null;

package/dist/cjs/serialization/resources/agents/types/RemoveCustomerAgentsResponseDataAttributes.js

@@ -41,6 +41,7 @@ const RemoveCustomerAgentsResponseDataAttributesStatus_js_1 = require("./RemoveC
 exports.RemoveCustomerAgentsResponseDataAttributes = core.serialization.object({
     name: core.serialization.string().nullable(),
     email: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
     status: RemoveCustomerAgentsResponseDataAttributesStatus_js_1.RemoveCustomerAgentsResponseDataAttributesStatus,
     permissions: core.serialization.list(core.serialization.string()),
     limits: RemoveCustomerAgentsResponseDataAttributesLimits_js_1.RemoveCustomerAgentsResponseDataAttributesLimits.nullable(),

package/dist/cjs/serialization/resources/index.d.ts

@@ -1,9 +1,6 @@
 export * from "./ach/client/requests/index.js";
 export * as ach from "./ach/index.js";
 export * from "./ach/types/index.js";
-export * from "./agentCards/client/requests/index.js";
-export * as agentCards from "./agentCards/index.js";
-export * from "./agentCards/types/index.js";
 export * from "./agenticPayments/client/requests/index.js";
 export * as agenticPayments from "./agenticPayments/index.js";
 export * from "./agenticPayments/types/index.js";
@@ -24,8 +21,6 @@ export * from "./cardPayments/types/index.js";
 export * from "./cardSessions/client/requests/index.js";
 export * as cardSessions from "./cardSessions/index.js";
 export * from "./cardSessions/types/index.js";
-export * as cardTransactions from "./cardTransactions/index.js";
-export * from "./cardTransactions/types/index.js";
 export * from "./chargebacks/client/requests/index.js";
 export * as chargebacks from "./chargebacks/index.js";
 export * from "./chargebacks/types/index.js";

package/dist/cjs/serialization/resources/index.js

@@ -36,13 +36,10 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.wire = exports.webhooks = exports.wallets = exports.voiceSessions = exports.transfers = exports.transactions = exports.simulations = exports.refunds = exports.realtime = exports.payments = exports.paymentRequests = exports.paymentIntents = exports.parties = exports.invitations = exports.invitationLinks = exports.externalPartyAccounts = exports.externalParties = exports.externalAccounts = exports.events = exports.customers = exports.chargebacks = exports.cardTransactions = exports.cardSessions = exports.cardPayments = exports.approvals = exports.apiKeys = exports.agents = exports.agentKeys = exports.agenticPayments = exports.agentCards = exports.ach = void 0;
+exports.wire = exports.webhooks = exports.wallets = exports.voiceSessions = exports.transfers = exports.transactions = exports.simulations = exports.refunds = exports.realtime = exports.payments = exports.paymentRequests = exports.paymentIntents = exports.parties = exports.invitations = exports.invitationLinks = exports.externalPartyAccounts = exports.externalParties = exports.externalAccounts = exports.events = exports.customers = exports.chargebacks = exports.cardSessions = exports.cardPayments = exports.approvals = exports.apiKeys = exports.agents = exports.agentKeys = exports.agenticPayments = exports.ach = void 0;
 __exportStar(require("./ach/client/requests/index.js"), exports);
 exports.ach = __importStar(require("./ach/index.js"));
 __exportStar(require("./ach/types/index.js"), exports);
-__exportStar(require("./agentCards/client/requests/index.js"), exports);
-exports.agentCards = __importStar(require("./agentCards/index.js"));
-__exportStar(require("./agentCards/types/index.js"), exports);
 __exportStar(require("./agenticPayments/client/requests/index.js"), exports);
 exports.agenticPayments = __importStar(require("./agenticPayments/index.js"));
 __exportStar(require("./agenticPayments/types/index.js"), exports);
@@ -63,8 +60,6 @@ __exportStar(require("./cardPayments/types/index.js"), exports);
 __exportStar(require("./cardSessions/client/requests/index.js"), exports);
 exports.cardSessions = __importStar(require("./cardSessions/index.js"));
 __exportStar(require("./cardSessions/types/index.js"), exports);
-exports.cardTransactions = __importStar(require("./cardTransactions/index.js"));
-__exportStar(require("./cardTransactions/types/index.js"), exports);
 __exportStar(require("./chargebacks/client/requests/index.js"), exports);
 exports.chargebacks = __importStar(require("./chargebacks/index.js"));
 __exportStar(require("./chargebacks/types/index.js"), exports);

package/dist/cjs/serialization/resources/paymentRequests/types/CancelPaymentRequestsResponseDataAttributesInitiatorParty.d.ts

@@ -7,5 +7,6 @@ export declare namespace CancelPaymentRequestsResponseDataAttributesInitiatorPar
         id: string;
         name: string;
         handle?: string | null;
+        avatarUrl?: string | null;
     }
 }

package/dist/cjs/serialization/resources/paymentRequests/types/CancelPaymentRequestsResponseDataAttributesInitiatorParty.js

@@ -40,4 +40,5 @@ exports.CancelPaymentRequestsResponseDataAttributesInitiatorParty = core.seriali
     id: core.serialization.string(),
     name: core.serialization.string(),
     handle: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
 });

package/dist/cjs/serialization/resources/paymentRequests/types/CreatePaymentRequestsResponseDataAttributesInitiatorParty.d.ts

@@ -7,5 +7,6 @@ export declare namespace CreatePaymentRequestsResponseDataAttributesInitiatorPar
         id: string;
         name: string;
         handle?: string | null;
+        avatarUrl?: string | null;
     }
 }

package/dist/cjs/serialization/resources/paymentRequests/types/CreatePaymentRequestsResponseDataAttributesInitiatorParty.js

@@ -40,4 +40,5 @@ exports.CreatePaymentRequestsResponseDataAttributesInitiatorParty = core.seriali
     id: core.serialization.string(),
     name: core.serialization.string(),
     handle: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
 });

package/dist/cjs/serialization/resources/paymentRequests/types/DeclinePaymentRequestsResponseDataAttributesInitiatorParty.d.ts

@@ -7,5 +7,6 @@ export declare namespace DeclinePaymentRequestsResponseDataAttributesInitiatorPa
         id: string;
         name: string;
         handle?: string | null;
+        avatarUrl?: string | null;
     }
 }

package/dist/cjs/serialization/resources/paymentRequests/types/DeclinePaymentRequestsResponseDataAttributesInitiatorParty.js

@@ -40,4 +40,5 @@ exports.DeclinePaymentRequestsResponseDataAttributesInitiatorParty = core.serial
     id: core.serialization.string(),
     name: core.serialization.string(),
     handle: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
 });

package/dist/cjs/serialization/resources/paymentRequests/types/GetPaymentRequestsResponseDataAttributesInitiatorParty.d.ts

@@ -7,5 +7,6 @@ export declare namespace GetPaymentRequestsResponseDataAttributesInitiatorParty
         id: string;
         name: string;
         handle?: string | null;
+        avatarUrl?: string | null;
     }
 }

package/dist/cjs/serialization/resources/paymentRequests/types/GetPaymentRequestsResponseDataAttributesInitiatorParty.js

@@ -40,4 +40,5 @@ exports.GetPaymentRequestsResponseDataAttributesInitiatorParty = core.serializat
     id: core.serialization.string(),
     name: core.serialization.string(),
     handle: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
 });

package/dist/cjs/serialization/resources/paymentRequests/types/ListIncomingPaymentRequestsResponseDataItemAttributesInitiatorParty.d.ts

@@ -7,5 +7,6 @@ export declare namespace ListIncomingPaymentRequestsResponseDataItemAttributesIn
         id: string;
         name: string;
         handle?: string | null;
+        avatarUrl?: string | null;
     }
 }

package/dist/cjs/serialization/resources/paymentRequests/types/ListIncomingPaymentRequestsResponseDataItemAttributesInitiatorParty.js

@@ -40,4 +40,5 @@ exports.ListIncomingPaymentRequestsResponseDataItemAttributesInitiatorParty = co
     id: core.serialization.string(),
     name: core.serialization.string(),
     handle: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
 });

package/dist/cjs/serialization/resources/paymentRequests/types/ListPaymentRequestsResponseDataItemAttributesInitiatorParty.d.ts

@@ -7,5 +7,6 @@ export declare namespace ListPaymentRequestsResponseDataItemAttributesInitiatorP
         id: string;
         name: string;
         handle?: string | null;
+        avatarUrl?: string | null;
     }
 }

package/dist/cjs/serialization/resources/paymentRequests/types/ListPaymentRequestsResponseDataItemAttributesInitiatorParty.js

@@ -40,4 +40,5 @@ exports.ListPaymentRequestsResponseDataItemAttributesInitiatorParty = core.seria
     id: core.serialization.string(),
     name: core.serialization.string(),
     handle: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
 });

package/dist/cjs/serialization/resources/simulations/types/DeclinePaymentRequestSimulationsResponseDataAttributesInitiatorParty.d.ts

@@ -7,5 +7,6 @@ export declare namespace DeclinePaymentRequestSimulationsResponseDataAttributesI
         id: string;
         name: string;
         handle?: string | null;
+        avatarUrl?: string | null;
     }
 }

package/dist/cjs/serialization/resources/simulations/types/DeclinePaymentRequestSimulationsResponseDataAttributesInitiatorParty.js

@@ -40,4 +40,5 @@ exports.DeclinePaymentRequestSimulationsResponseDataAttributesInitiatorParty = c
     id: core.serialization.string(),
     name: core.serialization.string(),
     handle: core.serialization.string().nullable(),
+    avatarUrl: core.serialization.string().nullable(),
 });

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "1.6.33";
+export declare const SDK_VERSION = "1.6.35";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "1.6.33";
+exports.SDK_VERSION = "1.6.35";

package/dist/esm/BaseClient.mjs

@@ -6,8 +6,8 @@ export function normalizeClientOptions(options) {
     const headers = mergeHeaders({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@naturalpay/sdk",
-        "X-Fern-SDK-Version": "1.6.33",
-        "User-Agent": "@naturalpay/sdk/1.6.33",
+        "X-Fern-SDK-Version": "1.6.35",
+        "User-Agent": "@naturalpay/sdk/1.6.35",
         "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/esm/Client.d.mts

@@ -1,5 +1,4 @@
 import { AchClient } from "./api/resources/ach/client/Client.mjs";
-import { AgentCardsClient } from "./api/resources/agentCards/client/Client.mjs";
 import { AgenticPaymentsClient } from "./api/resources/agenticPayments/client/Client.mjs";
 import { AgentKeysClient } from "./api/resources/agentKeys/client/Client.mjs";
 import { AgentsClient } from "./api/resources/agents/client/Client.mjs";
@@ -7,7 +6,6 @@ import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.mjs";
 import { ApprovalsClient } from "./api/resources/approvals/client/Client.mjs";
 import { CardPaymentsClient } from "./api/resources/cardPayments/client/Client.mjs";
 import { CardSessionsClient } from "./api/resources/cardSessions/client/Client.mjs";
-import { CardTransactionsClient } from "./api/resources/cardTransactions/client/Client.mjs";
 import { ChargebacksClient } from "./api/resources/chargebacks/client/Client.mjs";
 import { CustomersClient } from "./api/resources/customers/client/Client.mjs";
 import { EventsClient } from "./api/resources/events/client/Client.mjs";
@@ -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/esm/Client.mjs

@@ -9,7 +9,6 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { AchClient } from "./api/resources/ach/client/Client.mjs";
-import { AgentCardsClient } from "./api/resources/agentCards/client/Client.mjs";
 import { AgenticPaymentsClient } from "./api/resources/agenticPayments/client/Client.mjs";
 import { AgentKeysClient } from "./api/resources/agentKeys/client/Client.mjs";
 import { AgentsClient } from "./api/resources/agents/client/Client.mjs";
@@ -17,7 +16,6 @@ import { ApiKeysClient } from "./api/resources/apiKeys/client/Client.mjs";
 import { ApprovalsClient } from "./api/resources/approvals/client/Client.mjs";
 import { CardPaymentsClient } from "./api/resources/cardPayments/client/Client.mjs";
 import { CardSessionsClient } from "./api/resources/cardSessions/client/Client.mjs";
-import { CardTransactionsClient } from "./api/resources/cardTransactions/client/Client.mjs";
 import { ChargebacksClient } from "./api/resources/chargebacks/client/Client.mjs";
 import { CustomersClient } from "./api/resources/customers/client/Client.mjs";
 import { EventsClient } from "./api/resources/events/client/Client.mjs";
@@ -149,14 +147,6 @@ export class NaturalClient {
         var _a;
         return ((_a = this._agenticPayments) !== null && _a !== void 0 ? _a : (this._agenticPayments = new AgenticPaymentsClient(this._options)));
     }
-    get agentCards() {
-        var _a;
-        return ((_a = this._agentCards) !== null && _a !== void 0 ? _a : (this._agentCards = new AgentCardsClient(this._options)));
-    }
-    get cardTransactions() {
-        var _a;
-        return ((_a = this._cardTransactions) !== null && _a !== void 0 ? _a : (this._cardTransactions = new CardTransactionsClient(this._options)));
-    }
     get webhooks() {
         var _a;
         return ((_a = this._webhooks) !== null && _a !== void 0 ? _a : (this._webhooks = new WebhooksClient(this._options)));

package/dist/esm/api/resources/ach/client/requests/CancelAchParams.d.mts

@@ -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/esm/api/resources/ach/client/requests/GetAchRequest.d.mts

@@ -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/esm/api/resources/ach/client/requests/ListAchRequest.d.mts

@@ -4,11 +4,18 @@ import type * as Natural from "../../../../index.mjs";
  *     {}
  */
 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/esm/api/resources/agentKeys/client/requests/ListAgentKeysRequest.d.mts

@@ -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/esm/api/resources/agentKeys/client/requests/RevokeAgentKeysRequest.d.mts

@@ -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/esm/api/resources/agentKeys/client/requests/RotateAgentKeysRequest.d.mts

@@ -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/esm/api/resources/agenticPayments/client/Client.d.mts

@@ -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/esm/api/resources/agenticPayments/client/Client.mjs

@@ -32,6 +32,114 @@ export class AgenticPaymentsClient {
     constructor(options = {}) {
         this._options = 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 = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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 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/esm/api/resources/agenticPayments/client/requests/CancelPurchaseAgenticPaymentsRequest.d.mts

@@ -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/esm/api/resources/agenticPayments/client/requests/CardAgenticPaymentsRequest.d.mts

@@ -0,0 +1,15 @@
+import type * as Natural from "../../../../index.mjs";
+/**
+ * @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/esm/api/resources/agenticPayments/client/requests/ClaimPurchaseAgenticPaymentsRequest.d.mts

@@ -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/esm/api/resources/agenticPayments/client/requests/GetMandateAgenticPaymentsRequest.d.mts

@@ -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/esm/api/resources/agenticPayments/client/requests/GetPurchaseAgenticPaymentsRequest.d.mts

@@ -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/esm/api/resources/agenticPayments/client/requests/ListMandatesAgenticPaymentsRequest.d.mts

@@ -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/esm/api/resources/agenticPayments/client/requests/index.d.mts

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

package/dist/esm/api/resources/agenticPayments/types/CardAgenticPaymentsRequestProvider.d.mts

@@ -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/esm/api/resources/agenticPayments/types/CardAgenticPaymentsRequestProvider.mjs

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Payment method provider. */
+export const CardAgenticPaymentsRequestProvider = {
+    BasisTheory: "basis_theory",
+    Simulation: "simulation",
+};

package/dist/esm/api/resources/agenticPayments/types/CardAgenticPaymentsResponse.d.mts

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

package/dist/esm/api/resources/agenticPayments/types/CardAgenticPaymentsResponseData.d.mts

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