@linqapp/sdk 0.32.0 → 0.33.0

package/resources/payment-providers.d.mts

@@ -0,0 +1,58 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Let an agent pay on a customer's behalf with a single-use virtual card.
+ * Connect a customer once, then create a payment — a virtual card is minted
+ * scoped to that purchase and the card details are handed back for checkout.
+ */
+export declare class PaymentProviders extends APIResource {
+    /**
+     * Returns your organization's onboarding status for a payment provider.
+     *
+     * @example
+     * ```ts
+     * const paymentProvider =
+     *   await client.paymentProviders.retrieve('provider');
+     * ```
+     */
+    retrieve(provider: string, options?: RequestOptions): APIPromise<PaymentProvider>;
+    /**
+     * Begins connecting your organization to a payment provider (e.g. `agentcard`).
+     * Returns a hosted URL where an admin authorizes the connection; on completion the
+     * provider redirects back and Linq stores your connected credentials.
+     *
+     * @example
+     * ```ts
+     * const response = await client.paymentProviders.connect(
+     *   'provider',
+     *   {
+     *     return_url: 'https://partner.example/settings/payments',
+     *   },
+     * );
+     * ```
+     */
+    connect(provider: string, body: PaymentProviderConnectParams, options?: RequestOptions): APIPromise<PaymentProviderConnectResponse>;
+}
+export interface PaymentProvider {
+    provider?: string;
+    status?: 'onboarding' | 'ready' | 'disabled';
+}
+export interface PaymentProviderConnectResponse {
+    /**
+     * Send the admin here to authorize the connection.
+     */
+    hosted_url?: string;
+    session_id?: string;
+    status?: string;
+}
+export interface PaymentProviderConnectParams {
+    /**
+     * Where to send the admin after they authorize the connection.
+     */
+    return_url: string;
+}
+export declare namespace PaymentProviders {
+    export { type PaymentProvider as PaymentProvider, type PaymentProviderConnectResponse as PaymentProviderConnectResponse, type PaymentProviderConnectParams as PaymentProviderConnectParams, };
+}
+//# sourceMappingURL=payment-providers.d.mts.map

package/resources/payment-providers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-providers.d.mts","sourceRoot":"","sources":["../src/resources/payment-providers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,eAAe,CAAC;IAIjF;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,4BAA4B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;CAC9C;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/payment-providers.d.ts

@@ -0,0 +1,58 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Let an agent pay on a customer's behalf with a single-use virtual card.
+ * Connect a customer once, then create a payment — a virtual card is minted
+ * scoped to that purchase and the card details are handed back for checkout.
+ */
+export declare class PaymentProviders extends APIResource {
+    /**
+     * Returns your organization's onboarding status for a payment provider.
+     *
+     * @example
+     * ```ts
+     * const paymentProvider =
+     *   await client.paymentProviders.retrieve('provider');
+     * ```
+     */
+    retrieve(provider: string, options?: RequestOptions): APIPromise<PaymentProvider>;
+    /**
+     * Begins connecting your organization to a payment provider (e.g. `agentcard`).
+     * Returns a hosted URL where an admin authorizes the connection; on completion the
+     * provider redirects back and Linq stores your connected credentials.
+     *
+     * @example
+     * ```ts
+     * const response = await client.paymentProviders.connect(
+     *   'provider',
+     *   {
+     *     return_url: 'https://partner.example/settings/payments',
+     *   },
+     * );
+     * ```
+     */
+    connect(provider: string, body: PaymentProviderConnectParams, options?: RequestOptions): APIPromise<PaymentProviderConnectResponse>;
+}
+export interface PaymentProvider {
+    provider?: string;
+    status?: 'onboarding' | 'ready' | 'disabled';
+}
+export interface PaymentProviderConnectResponse {
+    /**
+     * Send the admin here to authorize the connection.
+     */
+    hosted_url?: string;
+    session_id?: string;
+    status?: string;
+}
+export interface PaymentProviderConnectParams {
+    /**
+     * Where to send the admin after they authorize the connection.
+     */
+    return_url: string;
+}
+export declare namespace PaymentProviders {
+    export { type PaymentProvider as PaymentProvider, type PaymentProviderConnectResponse as PaymentProviderConnectResponse, type PaymentProviderConnectParams as PaymentProviderConnectParams, };
+}
+//# sourceMappingURL=payment-providers.d.ts.map

package/resources/payment-providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-providers.d.ts","sourceRoot":"","sources":["../src/resources/payment-providers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,eAAe,CAAC;IAIjF;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,4BAA4B,EAClC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,8BAA8B,CAAC;CAG9C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,UAAU,CAAC;CAC9C;AAED,MAAM,WAAW,8BAA8B;IAC7C;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,gBAAgB,CAAC;IACxC,OAAO,EACL,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,8BAA8B,IAAI,8BAA8B,EACrE,KAAK,4BAA4B,IAAI,4BAA4B,GAClE,CAAC;CACH"}

package/resources/payment-providers.js

@@ -0,0 +1,45 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentProviders = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Let an agent pay on a customer's behalf with a single-use virtual card.
+ * Connect a customer once, then create a payment — a virtual card is minted
+ * scoped to that purchase and the card details are handed back for checkout.
+ */
+class PaymentProviders extends resource_1.APIResource {
+    /**
+     * Returns your organization's onboarding status for a payment provider.
+     *
+     * @example
+     * ```ts
+     * const paymentProvider =
+     *   await client.paymentProviders.retrieve('provider');
+     * ```
+     */
+    retrieve(provider, options) {
+        return this._client.get((0, path_1.path) `/v3/payments/providers/${provider}`, options);
+    }
+    /**
+     * Begins connecting your organization to a payment provider (e.g. `agentcard`).
+     * Returns a hosted URL where an admin authorizes the connection; on completion the
+     * provider redirects back and Linq stores your connected credentials.
+     *
+     * @example
+     * ```ts
+     * const response = await client.paymentProviders.connect(
+     *   'provider',
+     *   {
+     *     return_url: 'https://partner.example/settings/payments',
+     *   },
+     * );
+     * ```
+     */
+    connect(provider, body, options) {
+        return this._client.post((0, path_1.path) `/v3/payments/providers/${provider}/connect`, { body, ...options });
+    }
+}
+exports.PaymentProviders = PaymentProviders;
+//# sourceMappingURL=payment-providers.js.map

package/resources/payment-providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-providers.js","sourceRoot":"","sources":["../src/resources/payment-providers.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C;;;;GAIG;AACH,MAAa,gBAAiB,SAAQ,sBAAW;IAC/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,0BAA0B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,QAAgB,EAChB,IAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,0BAA0B,QAAQ,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;CACF;AApCD,4CAoCC"}

package/resources/payment-providers.mjs

@@ -0,0 +1,41 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../core/resource.mjs";
+import { path } from "../internal/utils/path.mjs";
+/**
+ * Let an agent pay on a customer's behalf with a single-use virtual card.
+ * Connect a customer once, then create a payment — a virtual card is minted
+ * scoped to that purchase and the card details are handed back for checkout.
+ */
+export class PaymentProviders extends APIResource {
+    /**
+     * Returns your organization's onboarding status for a payment provider.
+     *
+     * @example
+     * ```ts
+     * const paymentProvider =
+     *   await client.paymentProviders.retrieve('provider');
+     * ```
+     */
+    retrieve(provider, options) {
+        return this._client.get(path `/v3/payments/providers/${provider}`, options);
+    }
+    /**
+     * Begins connecting your organization to a payment provider (e.g. `agentcard`).
+     * Returns a hosted URL where an admin authorizes the connection; on completion the
+     * provider redirects back and Linq stores your connected credentials.
+     *
+     * @example
+     * ```ts
+     * const response = await client.paymentProviders.connect(
+     *   'provider',
+     *   {
+     *     return_url: 'https://partner.example/settings/payments',
+     *   },
+     * );
+     * ```
+     */
+    connect(provider, body, options) {
+        return this._client.post(path `/v3/payments/providers/${provider}/connect`, { body, ...options });
+    }
+}
+//# sourceMappingURL=payment-providers.mjs.map

package/resources/payment-providers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-providers.mjs","sourceRoot":"","sources":["../src/resources/payment-providers.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAG/C,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAE9C;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAgB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,0BAA0B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,QAAgB,EAChB,IAAkC,EAClC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,0BAA0B,QAAQ,UAAU,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;CACF"}

package/resources/payment-requests.d.mts

@@ -20,7 +20,7 @@ import { RequestOptions } from "../internal/request-options.mjs";
  *
  * ## Connected accounts (Stripe Standard, direct charges)
  *
- * Agent Pay runs on **Stripe Connect Standard accounts** using **direct
+ * Payments run on **Stripe Connect Standard accounts** using **direct
  * charges**: the charge is created on *your* connected account and **you are
  * the merchant of record**. That means the money, the payout schedule, the
  * customer relationship, and the compliance surface are all yours — Linq
@@ -103,7 +103,7 @@ import { RequestOptions } from "../internal/request-options.mjs";
  * no-install checkout sheet. Everywhere else (Android, desktop, iPhones
  * without the App Clip yet) the same URL opens the web checkout, so the link
  * always works. The App Clip experience for your payment links is registered
- * automatically by Linq and refreshed whenever you update your Agent Pay
+ * automatically by Linq and refreshed whenever you update your payments
  * branding; a newly registered experience can take up to ~24 hours to
  * activate on Apple's side, during which links open the web checkout.
  *

package/resources/payment-requests.d.ts

@@ -20,7 +20,7 @@ import { RequestOptions } from "../internal/request-options.js";
  *
  * ## Connected accounts (Stripe Standard, direct charges)
  *
- * Agent Pay runs on **Stripe Connect Standard accounts** using **direct
+ * Payments run on **Stripe Connect Standard accounts** using **direct
  * charges**: the charge is created on *your* connected account and **you are
  * the merchant of record**. That means the money, the payout schedule, the
  * customer relationship, and the compliance surface are all yours — Linq
@@ -103,7 +103,7 @@ import { RequestOptions } from "../internal/request-options.js";
  * no-install checkout sheet. Everywhere else (Android, desktop, iPhones
  * without the App Clip yet) the same URL opens the web checkout, so the link
  * always works. The App Clip experience for your payment links is registered
- * automatically by Linq and refreshed whenever you update your Agent Pay
+ * automatically by Linq and refreshed whenever you update your payments
  * branding; a newly registered experience can take up to ~24 hours to
  * activate on Apple's side, during which links open the web checkout.
  *

package/resources/payment-requests.js

@@ -24,7 +24,7 @@ const path_1 = require("../internal/utils/path.js");
  *
  * ## Connected accounts (Stripe Standard, direct charges)
  *
- * Agent Pay runs on **Stripe Connect Standard accounts** using **direct
+ * Payments run on **Stripe Connect Standard accounts** using **direct
  * charges**: the charge is created on *your* connected account and **you are
  * the merchant of record**. That means the money, the payout schedule, the
  * customer relationship, and the compliance surface are all yours — Linq
@@ -107,7 +107,7 @@ const path_1 = require("../internal/utils/path.js");
  * no-install checkout sheet. Everywhere else (Android, desktop, iPhones
  * without the App Clip yet) the same URL opens the web checkout, so the link
  * always works. The App Clip experience for your payment links is registered
- * automatically by Linq and refreshed whenever you update your Agent Pay
+ * automatically by Linq and refreshed whenever you update your payments
  * branding; a newly registered experience can take up to ~24 hours to
  * activate on Apple's side, during which links open the web checkout.
  *

package/resources/payment-requests.mjs

@@ -21,7 +21,7 @@ import { path } from "../internal/utils/path.mjs";
  *
  * ## Connected accounts (Stripe Standard, direct charges)
  *
- * Agent Pay runs on **Stripe Connect Standard accounts** using **direct
+ * Payments run on **Stripe Connect Standard accounts** using **direct
  * charges**: the charge is created on *your* connected account and **you are
  * the merchant of record**. That means the money, the payout schedule, the
  * customer relationship, and the compliance surface are all yours — Linq
@@ -104,7 +104,7 @@ import { path } from "../internal/utils/path.mjs";
  * no-install checkout sheet. Everywhere else (Android, desktop, iPhones
  * without the App Clip yet) the same URL opens the web checkout, so the link
  * always works. The App Clip experience for your payment links is registered
- * automatically by Linq and refreshed whenever you update your Agent Pay
+ * automatically by Linq and refreshed whenever you update your payments
  * branding; a newly registered experience can take up to ~24 hours to
  * activate on Apple's side, during which links open the web checkout.
  *

package/resources/payments.d.mts

@@ -0,0 +1,116 @@
+import { APIResource } from "../core/resource.mjs";
+import { APIPromise } from "../core/api-promise.mjs";
+import { RequestOptions } from "../internal/request-options.mjs";
+/**
+ * Let an agent pay on a customer's behalf with a single-use virtual card.
+ * Connect a customer once, then create a payment — a virtual card is minted
+ * scoped to that purchase and the card details are handed back for checkout.
+ */
+export declare class Payments extends APIResource {
+    /**
+     * Advances the pay flow for a connected customer handle and returns a `status`
+     * describing where it is (`needs_connection`, `awaiting_user_action`, `ready`,
+     * ...). A payment `id` appears once a card is minted. Idempotent on the
+     * `Idempotency-Key` header.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.create({
+     *   amount_cents: 2500,
+     *   currency: 'usd',
+     *   handle: '+14155550123',
+     * });
+     * ```
+     */
+    create(body: PaymentCreateParams, options?: RequestOptions): APIPromise<Payment>;
+    /**
+     * Get a payment
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.retrieve('paymentId');
+     * ```
+     */
+    retrieve(paymentID: string, options?: RequestOptions): APIPromise<Payment>;
+    /**
+     * Closes the virtual card and cancels the payment.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.cancel('paymentId');
+     * ```
+     */
+    cancel(paymentID: string, options?: RequestOptions): APIPromise<Payment>;
+    /**
+     * Returns a short-lived handoff for a `ready` payment. Fetch the card credentials
+     * **directly from the provider** with the returned `user_token` at `fetch_url` —
+     * the card number never passes through Linq. Do not persist PAN/CVC.
+     *
+     * @example
+     * ```ts
+     * const response = await client.payments.credentials(
+     *   'paymentId',
+     * );
+     * ```
+     */
+    credentials(paymentID: string, options?: RequestOptions): APIPromise<PaymentCredentialsResponse>;
+}
+export interface Payment {
+    id?: string;
+    amount_cents?: number;
+    /**
+     * Present when the customer must approve with a passkey.
+     */
+    approval_url?: string;
+    /**
+     * Present when the customer must attach a card.
+     */
+    attach_url?: string;
+    currency?: string;
+    description?: string;
+    handle?: string;
+    status?: 'needs_connection' | 'connecting' | 'awaiting_user_action' | 'ready' | 'authorized' | 'succeeded' | 'declined' | 'canceled' | 'expired';
+}
+export interface PaymentCredentialsResponse {
+    /**
+     * Fetch the card directly from the provider with these — never through Linq.
+     */
+    handoff?: PaymentCredentialsResponse.Handoff;
+}
+export declare namespace PaymentCredentialsResponse {
+    /**
+     * Fetch the card directly from the provider with these — never through Linq.
+     */
+    interface Handoff {
+        card_ref?: string;
+        fetch_url?: string;
+        provider?: string;
+        /**
+         * Short-lived bearer to fetch the card from the provider.
+         */
+        user_token?: string;
+    }
+}
+export interface PaymentCreateParams {
+    amount_cents: number;
+    currency: string;
+    /**
+     * Customer phone (E.164) or email.
+     */
+    handle: string;
+    description?: string;
+    merchant?: PaymentCreateParams.Merchant;
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export declare namespace PaymentCreateParams {
+    interface Merchant {
+        name?: string;
+        url?: string;
+    }
+}
+export declare namespace Payments {
+    export { type Payment as Payment, type PaymentCredentialsResponse as PaymentCredentialsResponse, type PaymentCreateParams as PaymentCreateParams, };
+}
+//# sourceMappingURL=payments.d.mts.map

package/resources/payments.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.mts","sourceRoot":"","sources":["../src/resources/payments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,6BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,gCAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,wCAAoC;AAG7D;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIhF;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAI1E;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIxE;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,0BAA0B,CAAC;CAGjG;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EACH,kBAAkB,GAClB,YAAY,GACZ,sBAAsB,GACtB,OAAO,GACP,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,SAAS,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC;CAC9C;AAED,yBAAiB,0BAA0B,CAAC;IAC1C;;OAEG;IACH,UAAiB,OAAO;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC;IAExC,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,yBAAiB,mBAAmB,CAAC;IACnC,UAAiB,QAAQ;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/payments.d.ts

@@ -0,0 +1,116 @@
+import { APIResource } from "../core/resource.js";
+import { APIPromise } from "../core/api-promise.js";
+import { RequestOptions } from "../internal/request-options.js";
+/**
+ * Let an agent pay on a customer's behalf with a single-use virtual card.
+ * Connect a customer once, then create a payment — a virtual card is minted
+ * scoped to that purchase and the card details are handed back for checkout.
+ */
+export declare class Payments extends APIResource {
+    /**
+     * Advances the pay flow for a connected customer handle and returns a `status`
+     * describing where it is (`needs_connection`, `awaiting_user_action`, `ready`,
+     * ...). A payment `id` appears once a card is minted. Idempotent on the
+     * `Idempotency-Key` header.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.create({
+     *   amount_cents: 2500,
+     *   currency: 'usd',
+     *   handle: '+14155550123',
+     * });
+     * ```
+     */
+    create(body: PaymentCreateParams, options?: RequestOptions): APIPromise<Payment>;
+    /**
+     * Get a payment
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.retrieve('paymentId');
+     * ```
+     */
+    retrieve(paymentID: string, options?: RequestOptions): APIPromise<Payment>;
+    /**
+     * Closes the virtual card and cancels the payment.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.cancel('paymentId');
+     * ```
+     */
+    cancel(paymentID: string, options?: RequestOptions): APIPromise<Payment>;
+    /**
+     * Returns a short-lived handoff for a `ready` payment. Fetch the card credentials
+     * **directly from the provider** with the returned `user_token` at `fetch_url` —
+     * the card number never passes through Linq. Do not persist PAN/CVC.
+     *
+     * @example
+     * ```ts
+     * const response = await client.payments.credentials(
+     *   'paymentId',
+     * );
+     * ```
+     */
+    credentials(paymentID: string, options?: RequestOptions): APIPromise<PaymentCredentialsResponse>;
+}
+export interface Payment {
+    id?: string;
+    amount_cents?: number;
+    /**
+     * Present when the customer must approve with a passkey.
+     */
+    approval_url?: string;
+    /**
+     * Present when the customer must attach a card.
+     */
+    attach_url?: string;
+    currency?: string;
+    description?: string;
+    handle?: string;
+    status?: 'needs_connection' | 'connecting' | 'awaiting_user_action' | 'ready' | 'authorized' | 'succeeded' | 'declined' | 'canceled' | 'expired';
+}
+export interface PaymentCredentialsResponse {
+    /**
+     * Fetch the card directly from the provider with these — never through Linq.
+     */
+    handoff?: PaymentCredentialsResponse.Handoff;
+}
+export declare namespace PaymentCredentialsResponse {
+    /**
+     * Fetch the card directly from the provider with these — never through Linq.
+     */
+    interface Handoff {
+        card_ref?: string;
+        fetch_url?: string;
+        provider?: string;
+        /**
+         * Short-lived bearer to fetch the card from the provider.
+         */
+        user_token?: string;
+    }
+}
+export interface PaymentCreateParams {
+    amount_cents: number;
+    currency: string;
+    /**
+     * Customer phone (E.164) or email.
+     */
+    handle: string;
+    description?: string;
+    merchant?: PaymentCreateParams.Merchant;
+    metadata?: {
+        [key: string]: string;
+    };
+}
+export declare namespace PaymentCreateParams {
+    interface Merchant {
+        name?: string;
+        url?: string;
+    }
+}
+export declare namespace Payments {
+    export { type Payment as Payment, type PaymentCredentialsResponse as PaymentCredentialsResponse, type PaymentCreateParams as PaymentCreateParams, };
+}
+//# sourceMappingURL=payments.d.ts.map

package/resources/payments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.d.ts","sourceRoot":"","sources":["../src/resources/payments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,4BAAyB;AAC/C,OAAO,EAAE,UAAU,EAAE,+BAA4B;AACjD,OAAO,EAAE,cAAc,EAAE,uCAAoC;AAG7D;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIhF;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAI1E;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIxE;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,0BAA0B,CAAC;CAGjG;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,MAAM,CAAC,EACH,kBAAkB,GAClB,YAAY,GACZ,sBAAsB,GACtB,OAAO,GACP,YAAY,GACZ,WAAW,GACX,UAAU,GACV,UAAU,GACV,SAAS,CAAC;CACf;AAED,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC,OAAO,CAAC;CAC9C;AAED,yBAAiB,0BAA0B,CAAC;IAC1C;;OAEG;IACH,UAAiB,OAAO;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB,SAAS,CAAC,EAAE,MAAM,CAAC;QAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IAErB,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC;IAExC,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,yBAAiB,mBAAmB,CAAC;IACnC,UAAiB,QAAQ;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QAEd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;CACF;AAED,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/payments.js

@@ -0,0 +1,70 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payments = void 0;
+const resource_1 = require("../core/resource.js");
+const path_1 = require("../internal/utils/path.js");
+/**
+ * Let an agent pay on a customer's behalf with a single-use virtual card.
+ * Connect a customer once, then create a payment — a virtual card is minted
+ * scoped to that purchase and the card details are handed back for checkout.
+ */
+class Payments extends resource_1.APIResource {
+    /**
+     * Advances the pay flow for a connected customer handle and returns a `status`
+     * describing where it is (`needs_connection`, `awaiting_user_action`, `ready`,
+     * ...). A payment `id` appears once a card is minted. Idempotent on the
+     * `Idempotency-Key` header.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.create({
+     *   amount_cents: 2500,
+     *   currency: 'usd',
+     *   handle: '+14155550123',
+     * });
+     * ```
+     */
+    create(body, options) {
+        return this._client.post('/v3/payments', { body, ...options });
+    }
+    /**
+     * Get a payment
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.retrieve('paymentId');
+     * ```
+     */
+    retrieve(paymentID, options) {
+        return this._client.get((0, path_1.path) `/v3/payments/${paymentID}`, options);
+    }
+    /**
+     * Closes the virtual card and cancels the payment.
+     *
+     * @example
+     * ```ts
+     * const payment = await client.payments.cancel('paymentId');
+     * ```
+     */
+    cancel(paymentID, options) {
+        return this._client.post((0, path_1.path) `/v3/payments/${paymentID}/cancel`, options);
+    }
+    /**
+     * Returns a short-lived handoff for a `ready` payment. Fetch the card credentials
+     * **directly from the provider** with the returned `user_token` at `fetch_url` —
+     * the card number never passes through Linq. Do not persist PAN/CVC.
+     *
+     * @example
+     * ```ts
+     * const response = await client.payments.credentials(
+     *   'paymentId',
+     * );
+     * ```
+     */
+    credentials(paymentID, options) {
+        return this._client.get((0, path_1.path) `/v3/payments/${paymentID}/credentials`, options);
+    }
+}
+exports.Payments = Payments;
+//# sourceMappingURL=payments.js.map

package/resources/payments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payments.js","sourceRoot":"","sources":["../src/resources/payments.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAG/C,oDAA8C;AAE9C;;;;GAIG;AACH,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAiB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,SAAiB,EAAE,OAAwB;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,SAAS,cAAc,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACF;AA3DD,4BA2DC"}