stripe 17.7.0 → 17.8.0-beta.1

package/types/PaymentRecords.d.ts

@@ -0,0 +1,242 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    /**
+     * A Payment Record is a resource that allows you to represent payments that occur on- or off-Stripe.
+     * For example, you can create a Payment Record to model a payment made on a different payment processor,
+     * in order to mark an Invoice as paid and a Subscription as active. Payment Records consist of one or
+     * more Payment Attempt Records, which represent individual attempts made on a payment network.
+     */
+    interface PaymentRecord {
+      /**
+       * Unique identifier for the object.
+       */
+      id: string;
+
+      /**
+       * String representing the object's type. Objects of the same type share the same value.
+       */
+      object: 'payment_record';
+
+      /**
+       * A representation of an amount of money, consisting of an amount and a currency.
+       */
+      amount_canceled: PaymentRecord.AmountCanceled;
+
+      /**
+       * A representation of an amount of money, consisting of an amount and a currency.
+       */
+      amount_failed: PaymentRecord.AmountFailed;
+
+      /**
+       * A representation of an amount of money, consisting of an amount and a currency.
+       */
+      amount_guaranteed: PaymentRecord.AmountGuaranteed;
+
+      /**
+       * A representation of an amount of money, consisting of an amount and a currency.
+       */
+      amount_requested: PaymentRecord.AmountRequested;
+
+      /**
+       * Time at which the object was created. Measured in seconds since the Unix epoch.
+       */
+      created: number;
+
+      /**
+       * Customer information for this payment.
+       */
+      customer_details: PaymentRecord.CustomerDetails | null;
+
+      /**
+       * Indicates whether the customer was present in your checkout flow during this payment.
+       */
+      customer_presence: PaymentRecord.CustomerPresence | null;
+
+      /**
+       * An arbitrary string attached to the object. Often useful for displaying to users.
+       */
+      description: string | null;
+
+      /**
+       * ID of the latest Payment Attempt Record attached to this Payment Record.
+       */
+      latest_payment_attempt_record: string;
+
+      /**
+       * Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
+       */
+      livemode: boolean;
+
+      /**
+       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
+       */
+      metadata: Stripe.Metadata | null;
+
+      /**
+       * Information about the Payment Method debited for this payment.
+       */
+      payment_method_details: PaymentRecord.PaymentMethodDetails | null;
+
+      /**
+       * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+       */
+      payment_reference: string | null;
+
+      /**
+       * Shipping information for this payment.
+       */
+      shipping_details: PaymentRecord.ShippingDetails | null;
+    }
+
+    namespace PaymentRecord {
+      interface AmountCanceled {
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) e.g., 100 cents for $1.00 or 100 for ¥100, a zero-decimal currency).
+         */
+        value: number;
+      }
+
+      interface AmountFailed {
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) e.g., 100 cents for $1.00 or 100 for ¥100, a zero-decimal currency).
+         */
+        value: number;
+      }
+
+      interface AmountGuaranteed {
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) e.g., 100 cents for $1.00 or 100 for ¥100, a zero-decimal currency).
+         */
+        value: number;
+      }
+
+      interface AmountRequested {
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) e.g., 100 cents for $1.00 or 100 for ¥100, a zero-decimal currency).
+         */
+        value: number;
+      }
+
+      interface CustomerDetails {
+        /**
+         * ID of the Stripe Customer associated with this payment.
+         */
+        customer: string | null;
+
+        /**
+         * The customer's email address.
+         */
+        email: string | null;
+
+        /**
+         * The customer's name.
+         */
+        name: string | null;
+
+        /**
+         * The customer's phone number.
+         */
+        phone: string | null;
+      }
+
+      type CustomerPresence = 'off_session' | 'on_session';
+
+      interface PaymentMethodDetails {
+        /**
+         * The billing details associated with the method of payment.
+         */
+        billing_details: PaymentMethodDetails.BillingDetails | null;
+
+        /**
+         * Information about the custom (user-defined) payment method used to make this payment.
+         */
+        custom: PaymentMethodDetails.Custom | null;
+
+        /**
+         * ID of the Stripe PaymentMethod used to make this payment.
+         */
+        payment_method: string | null;
+
+        /**
+         * The type of Payment Method used for this payment attempt.
+         */
+        type: 'custom';
+      }
+
+      namespace PaymentMethodDetails {
+        interface BillingDetails {
+          /**
+           * A representation of a physical address.
+           */
+          address: Stripe.Address;
+
+          /**
+           * The billing email associated with the method of payment.
+           */
+          email: string | null;
+
+          /**
+           * The billing name associated with the method of payment.
+           */
+          name: string | null;
+
+          /**
+           * The billing phone number associated with the method of payment.
+           */
+          phone: string | null;
+        }
+
+        interface Custom {
+          /**
+           * Display name for the custom (user-defined) payment method type used to make this payment.
+           */
+          display_name: string;
+
+          /**
+           * The custom payment method type associated with this payment.
+           */
+          type: string | null;
+        }
+      }
+
+      interface ShippingDetails {
+        /**
+         * A representation of a physical address.
+         */
+        address: Stripe.Address;
+
+        /**
+         * The shipping recipient's name.
+         */
+        name: string | null;
+
+        /**
+         * The shipping recipient's phone number.
+         */
+        phone: string | null;
+      }
+    }
+  }
+}

package/types/PaymentRecordsResource.d.ts

@@ -0,0 +1,455 @@
+// File generated from our OpenAPI spec
+
+declare module 'stripe' {
+  namespace Stripe {
+    interface PaymentRecordRetrieveParams {
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+    }
+
+    interface PaymentRecordReportPaymentParams {
+      /**
+       * The amount you intend to collect for this payment.
+       */
+      amount_requested: PaymentRecordReportPaymentParams.AmountRequested;
+
+      /**
+       * When the reported payment was initiated. Measured in seconds since the Unix epoch.
+       */
+      initiated_at: number;
+
+      /**
+       * Information about the Payment Method debited for this payment.
+       */
+      payment_method_details: PaymentRecordReportPaymentParams.PaymentMethodDetails;
+
+      /**
+       * An opaque string for manual reconciliation of this payment, for example a check number or a payment processor ID.
+       */
+      payment_reference: string;
+
+      /**
+       * Customer information for this payment.
+       */
+      customer_details?: PaymentRecordReportPaymentParams.CustomerDetails;
+
+      /**
+       * Indicates whether the customer was present in your checkout flow during this payment.
+       */
+      customer_presence?: PaymentRecordReportPaymentParams.CustomerPresence;
+
+      /**
+       * An arbitrary string attached to the object. Often useful for displaying to users.
+       */
+      description?: string;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      /**
+       * Information about the payment attempt failure.
+       */
+      failed?: PaymentRecordReportPaymentParams.Failed;
+
+      /**
+       * Information about the payment attempt guarantee.
+       */
+      guaranteed?: PaymentRecordReportPaymentParams.Guaranteed;
+
+      /**
+       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       */
+      metadata?: Stripe.MetadataParam;
+
+      /**
+       * The outcome of the reported payment.
+       */
+      outcome?: PaymentRecordReportPaymentParams.Outcome;
+
+      /**
+       * Shipping information for this payment.
+       */
+      shipping_details?: PaymentRecordReportPaymentParams.ShippingDetails;
+    }
+
+    namespace PaymentRecordReportPaymentParams {
+      interface AmountRequested {
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * A positive integer representing the amount in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) e.g., 100 cents for $1.00 or 100 for ¥100, a zero-decimal currency).
+         */
+        value: number;
+      }
+
+      interface CustomerDetails {
+        /**
+         * The customer who made the payment.
+         */
+        customer?: string;
+
+        /**
+         * The customer's phone number.
+         */
+        email?: string;
+
+        /**
+         * The customer's name.
+         */
+        name?: string;
+
+        /**
+         * The customer's phone number.
+         */
+        phone?: string;
+      }
+
+      type CustomerPresence = 'off_session' | 'on_session';
+
+      interface Failed {
+        /**
+         * When the reported payment failed. Measured in seconds since the Unix epoch.
+         */
+        failed_at: number;
+      }
+
+      interface Guaranteed {
+        /**
+         * When the reported payment was guaranteed. Measured in seconds since the Unix epoch.
+         */
+        guaranteed_at: number;
+      }
+
+      type Outcome = 'failed' | 'guaranteed';
+
+      interface PaymentMethodDetails {
+        /**
+         * The billing details associated with the method of payment.
+         */
+        billing_details?: PaymentMethodDetails.BillingDetails;
+
+        /**
+         * Information about the custom (user-defined) payment method used to make this payment.
+         */
+        custom?: PaymentMethodDetails.Custom;
+
+        /**
+         * ID of the Stripe Payment Method used to make this payment.
+         */
+        payment_method?: string;
+
+        /**
+         * The type of the payment method details. An additional hash is included on the payment_method_details with a name matching this value. It contains additional information specific to the type.
+         */
+        type?: 'custom';
+      }
+
+      namespace PaymentMethodDetails {
+        interface BillingDetails {
+          /**
+           * The billing address associated with the method of payment.
+           */
+          address?: Stripe.AddressParam;
+
+          /**
+           * The billing email associated with the method of payment.
+           */
+          email?: string;
+
+          /**
+           * The billing name associated with the method of payment.
+           */
+          name?: string;
+
+          /**
+           * The billing phone number associated with the method of payment.
+           */
+          phone?: string;
+        }
+
+        interface Custom {
+          /**
+           * Display name for the custom (user-defined) payment method type used to make this payment.
+           */
+          display_name?: string;
+
+          /**
+           * The custom payment method type associated with this payment.
+           */
+          type?: string;
+        }
+      }
+
+      interface ShippingDetails {
+        /**
+         * The physical shipping address.
+         */
+        address?: Stripe.AddressParam;
+
+        /**
+         * The shipping recipient's name.
+         */
+        name?: string;
+
+        /**
+         * The shipping recipient's phone number.
+         */
+        phone?: string;
+      }
+    }
+
+    interface PaymentRecordReportPaymentAttemptParams {
+      /**
+       * When the reported payment was initiated. Measured in seconds since the Unix epoch.
+       */
+      initiated_at: number;
+
+      /**
+       * An arbitrary string attached to the object. Often useful for displaying to users.
+       */
+      description?: string;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      /**
+       * Information about the payment attempt failure.
+       */
+      failed?: PaymentRecordReportPaymentAttemptParams.Failed;
+
+      /**
+       * Information about the payment attempt guarantee.
+       */
+      guaranteed?: PaymentRecordReportPaymentAttemptParams.Guaranteed;
+
+      /**
+       * Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.
+       */
+      metadata?: Stripe.MetadataParam;
+
+      /**
+       * The outcome of the reported payment.
+       */
+      outcome?: PaymentRecordReportPaymentAttemptParams.Outcome;
+
+      /**
+       * Information about the Payment Method debited for this payment.
+       */
+      payment_method_details?: PaymentRecordReportPaymentAttemptParams.PaymentMethodDetails;
+
+      /**
+       * Shipping information for this payment.
+       */
+      shipping_details?: PaymentRecordReportPaymentAttemptParams.ShippingDetails;
+    }
+
+    namespace PaymentRecordReportPaymentAttemptParams {
+      interface Failed {
+        /**
+         * When the reported payment failed. Measured in seconds since the Unix epoch.
+         */
+        failed_at: number;
+      }
+
+      interface Guaranteed {
+        /**
+         * When the reported payment was guaranteed. Measured in seconds since the Unix epoch.
+         */
+        guaranteed_at: number;
+      }
+
+      type Outcome = 'failed' | 'guaranteed';
+
+      interface PaymentMethodDetails {
+        /**
+         * The billing details associated with the method of payment.
+         */
+        billing_details?: PaymentMethodDetails.BillingDetails;
+
+        /**
+         * Information about the custom (user-defined) payment method used to make this payment.
+         */
+        custom?: PaymentMethodDetails.Custom;
+
+        /**
+         * ID of the Stripe Payment Method used to make this payment.
+         */
+        payment_method?: string;
+
+        /**
+         * The type of the payment method details. An additional hash is included on the payment_method_details with a name matching this value. It contains additional information specific to the type.
+         */
+        type?: 'custom';
+      }
+
+      namespace PaymentMethodDetails {
+        interface BillingDetails {
+          /**
+           * The billing address associated with the method of payment.
+           */
+          address?: Stripe.AddressParam;
+
+          /**
+           * The billing email associated with the method of payment.
+           */
+          email?: string;
+
+          /**
+           * The billing name associated with the method of payment.
+           */
+          name?: string;
+
+          /**
+           * The billing phone number associated with the method of payment.
+           */
+          phone?: string;
+        }
+
+        interface Custom {
+          /**
+           * Display name for the custom (user-defined) payment method type used to make this payment.
+           */
+          display_name?: string;
+
+          /**
+           * The custom payment method type associated with this payment.
+           */
+          type?: string;
+        }
+      }
+
+      interface ShippingDetails {
+        /**
+         * The physical shipping address.
+         */
+        address?: Stripe.AddressParam;
+
+        /**
+         * The shipping recipient's name.
+         */
+        name?: string;
+
+        /**
+         * The shipping recipient's phone number.
+         */
+        phone?: string;
+      }
+    }
+
+    interface PaymentRecordReportPaymentAttemptCanceledParams {
+      /**
+       * When the reported payment was canceled. Measured in seconds since the Unix epoch.
+       */
+      canceled_at: number;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      metadata?: Stripe.MetadataParam;
+    }
+
+    interface PaymentRecordReportPaymentAttemptFailedParams {
+      /**
+       * When the reported payment failed. Measured in seconds since the Unix epoch.
+       */
+      failed_at: number;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      metadata?: Stripe.MetadataParam;
+    }
+
+    interface PaymentRecordReportPaymentAttemptGuaranteedParams {
+      /**
+       * When the reported payment was guaranteed. Measured in seconds since the Unix epoch.
+       */
+      guaranteed_at: number;
+
+      /**
+       * Specifies which fields in the response should be expanded.
+       */
+      expand?: Array<string>;
+
+      metadata?: Stripe.MetadataParam;
+    }
+
+    class PaymentRecordsResource {
+      /**
+       * Retrieves a Payment Record with the given ID
+       */
+      retrieve(
+        id: string,
+        params?: PaymentRecordRetrieveParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+      retrieve(
+        id: string,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+
+      /**
+       * Report a new Payment Record. You may report a Payment Record as it is
+       *  initialized and later report updates through the other report_* methods, or report Payment
+       *  Records in a terminal state directly, through this method.
+       */
+      reportPayment(
+        params: PaymentRecordReportPaymentParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+
+      /**
+       * Report a new payment attempt on the specified Payment Record. A new payment
+       *  attempt can only be specified if all other payment attempts are canceled or failed.
+       */
+      reportPaymentAttempt(
+        id: string,
+        params: PaymentRecordReportPaymentAttemptParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+
+      /**
+       * Report that the most recent payment attempt on the specified Payment Record
+       *  was canceled.
+       */
+      reportPaymentAttemptCanceled(
+        id: string,
+        params: PaymentRecordReportPaymentAttemptCanceledParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+
+      /**
+       * Report that the most recent payment attempt on the specified Payment Record
+       *  failed or errored.
+       */
+      reportPaymentAttemptFailed(
+        id: string,
+        params: PaymentRecordReportPaymentAttemptFailedParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+
+      /**
+       * Report that the most recent payment attempt on the specified Payment Record
+       *  was guaranteed.
+       */
+      reportPaymentAttemptGuaranteed(
+        id: string,
+        params: PaymentRecordReportPaymentAttemptGuaranteedParams,
+        options?: RequestOptions
+      ): Promise<Stripe.Response<Stripe.PaymentRecord>>;
+    }
+  }
+}