# List All Checkout Sessions

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/checkout/sessions/list:
    get:
      summary: List All Checkout Sessions
      deprecated: false
      description: Returns a list of Checkout Sessions.
      tags:
        - API Reference/Checkout
      parameters:
        - name: Accept
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
        - name: Content-Type
          in: header
          description: ''
          required: true
          example: application/json
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              x-apifox-refs:
                01GMQNM6TA7GCYB319KV9793TY:
                  $ref: '#/components/schemas/List%20Request'
                  x-apifox-overrides: {}
              properties:
                created:
                  type: object
                  properties:
                    gt:
                      type: string
                      description: >-
                        Return results where the created field is greater than
                        this value.
                    gte:
                      type: string
                      description: >-
                        Return results where the created field is greater than
                        or equal to this value.
                    lt:
                      type: string
                      description: >-
                        Return results where the created field is less than this
                        value.
                    lte:
                      type: string
                      description: >-
                        Return results where the created field is less than or
                        equal to this value.
                  description: >-
                    A filter on the list based on the object created field. The
                    value can be a string with an integer Unix timestamp, or it
                    can be a dictionary with the following options:
                  x-apifox-orders:
                    - gt
                    - gte
                    - lt
                    - lte
                  x-apifox-ignore-properties: []
                ending_before:
                  type: string
                  description: >-
                    A cursor for use in pagination. ending_before is an object
                    ID that defines your place in the list. For instance, if you
                    make a list request and receive 100 objects, starting with
                    obj_bar, your subsequent call can include
                    ending_before=obj_bar in order to fetch the previous page of
                    the list.
                limit:
                  type: integer
                  description: >-
                    A limit on the number of objects to be returned. Limit can
                    range between 1 and 100, and the default is 10.
                starting_after:
                  type: string
                  description: >-
                    A cursor for use in pagination. starting_after is an object
                    ID that defines your place in the list. For instance, if you
                    make a list request and receive 100 objects, ending with
                    obj_foo, your subsequent call can include
                    starting_after=obj_foo in order to fetch the next page of
                    the list.
                customer:
                  type: string
                  description: >-
                    Only return the Checkout Sessions for the Customer
                    specified.
                customer_details:
                  type: object
                  properties:
                    email:
                      type: string
                      description: Customer’s email address.
                  x-apifox-orders:
                    - email
                  description: >-
                    Only return the Checkout Sessions for the Customer details
                    specified.
                  required:
                    - email
                  x-apifox-ignore-properties: []
                payment_intent:
                  type: string
                  description: >-
                    Only return the Checkout Session for the PaymentIntent
                    specified.
              x-apifox-orders:
                - 01GMQNM6TA7GCYB319KV9793TY
                - customer
                - customer_details
                - payment_intent
              x-apifox-ignore-properties:
                - created
                - ending_before
                - limit
                - starting_after
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                x-apifox-refs:
                  01GMQNR2HFET2WFY1YD89QM5HZ: &ref_0
                    $ref: '#/components/schemas/List'
                    x-apifox-overrides:
                      data: &ref_4
                        type: array
                        items:
                          type: object
                          x-apifox-refs:
                            01GMQGC5BJT0A3P7BG6BZD73SD: &ref_66
                              $ref: '#/components/schemas/item'
                              x-apifox-overrides:
                                amount_tax: null
                                taxes: null
                          x-apifox-orders:
                            - 01GMQGC5BJT0A3P7BG6BZD73SD
                          properties:
                            id:
                              type: string
                              description: Unique identifier for the object, like "li_xxx"
                            object:
                              type: string
                              description: >-
                                String representing the object’s type. Objects
                                of the same type share the same value.
                            amount_subtotal:
                              type: string
                              description: Total before any discounts or taxes are applied.
                            amount_total:
                              type: string
                              description: Total after discounts and taxes.
                            currency:
                              type: string
                              description: Three-letter ISO currency code.
                            description:
                              type: string
                              description: >-
                                An arbitrary string attached to the object.
                                Often useful for displaying to users. Defaults
                                to product name.
                            price:
                              type: object
                              x-apifox-refs:
                                01GMQG5R25JKZG1CEB31ZYK9A1: &ref_23
                                  $ref: '#/components/schemas/Price'
                                  x-apifox-overrides:
                                    custom_unit_amount: null
                                    tax_behavior: null
                                    tiers_mode: null
                                    transform_quantity: null
                                    unit_amount_decimal: null
                              x-apifox-orders:
                                - 01GMQG5R25JKZG1CEB31ZYK9A1
                              properties:
                                id:
                                  type: string
                                  description: >-
                                    Unique identifier for the object, like
                                    "price_xxxx".
                                object:
                                  type: string
                                  description: '''price'''
                                active:
                                  type: boolean
                                  description: >-
                                    Whether the price can be used for new
                                    purchases.
                                billing_scheme:
                                  type: string
                                  description: >-
                                    Describes how to compute the price per
                                    period. Either per_unit or tiered
                                  enum:
                                    - per_unit
                                    - tiered
                                  x-apifox-enum:
                                    - value: per_unit
                                      name: ''
                                      description: only per_unit is supported now.
                                    - value: tiered
                                      name: ''
                                      description: ''
                                created:
                                  type: integer
                                  description: >-
                                    Time at which the object was created.
                                    Measured in seconds since the Unix epoch.
                                currency:
                                  type: string
                                  description: >-
                                    Three-letter ISO currency code, in
                                    uppercase. 
                                livemode:
                                  type: boolean
                                  description: >-
                                    Has the value true if the object exists in
                                    live mode or the value false if the object
                                    exists in test mode.
                                lookup_key:
                                  type: string
                                  description: >-
                                    A lookup key used to retrieve prices
                                    dynamically from a static string. This may
                                    be up to 200 characters.
                                metadata:
                                  type: object
                                  properties: {}
                                  x-apifox-orders: []
                                  description: >-
                                    Set of key-value pairs that you can attach
                                    to an object. This can be useful for storing
                                    additional information about the object in a
                                    structured format.
                                  x-apifox-ignore-properties: []
                                nickname:
                                  type: string
                                  description: >-
                                    A brief description of the price, hidden
                                    from customers.
                                product:
                                  type: string
                                  description: >-
                                    The ID of the product this price is
                                    associated with.
                                type:
                                  type: string
                                  description: >-
                                    One of one_time or recurring depending on
                                    whether the price is for a one-time purchase
                                    or a recurring (subscription) purchase.
                                  enum:
                                    - one_time
                                    - recurring
                                  x-apifox-enum:
                                    - value: one_time
                                      name: ''
                                      description: only one-time is supported now.
                                    - value: recurring
                                      name: ''
                                      description: ''
                                unit_amount:
                                  type: integer
                                  description: >-
                                    The unit amount in cents to be charged,
                                    represented as a whole integer if possible.
                                    Only set if billing_scheme=per_unit.
                                recurring:
                                  type: object
                                  properties:
                                    interval:
                                      type: string
                                      description: >-
                                        The frequency at which a subscription is
                                        billed. One of day, week, month or year.
                                      enum:
                                        - day
                                        - week
                                        - month
                                        - year
                                      x-apifox-enum:
                                        - value: day
                                          name: ''
                                          description: ''
                                        - value: week
                                          name: ''
                                          description: ''
                                        - value: month
                                          name: ''
                                          description: ''
                                        - value: year
                                          name: ''
                                          description: ''
                                    interval_count:
                                      type: integer
                                      description: >-
                                        The number of intervals (specified in
                                        the interval attribute) between
                                        subscription billings. For example,
                                        interval=month and interval_count=3
                                        bills every 3 months.
                                    usage_type:
                                      type: string
                                      description: >-
                                        Configures how the quantity per period
                                        should be determined.
                                      enum:
                                        - licensed
                                      x-apifox-enum:
                                        - value: licensed
                                          name: ''
                                          description: ''
                                  x-apifox-orders:
                                    - interval
                                    - interval_count
                                    - usage_type
                                  description: The recurring components of a price
                                  required:
                                    - interval
                                  x-apifox-ignore-properties: []
                                tiers:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      up_to:
                                        type: string
                                        description: >-
                                          Specifies the upper bound of this tier.
                                          The lower bound of a tier is the upper
                                          bound of the previous tier adding one.
                                          Use inf to define a fallback tier.
                                      flat_amount:
                                        type: string
                                        description: >-
                                          The flat billing amount for an entire
                                          tier, regardless of the number of units
                                          in the tier.
                                      unit_amount:
                                        type: string
                                        description: >-
                                          The per unit billing amount for each
                                          individual unit for which this tier
                                          applies.
                                    x-apifox-orders:
                                      - up_to
                                      - flat_amount
                                      - unit_amount
                                    x-apifox-ignore-properties: []
                                  description: （未实现）
                              description: The price used to generate the line item.
                              x-apifox-ignore-properties:
                                - id
                                - object
                                - active
                                - billing_scheme
                                - created
                                - currency
                                - livemode
                                - lookup_key
                                - metadata
                                - nickname
                                - product
                                - type
                                - unit_amount
                                - recurring
                                - tiers
                            quantity:
                              type: string
                              description: The quantity of products being purchased.
                            discounts:
                              type: array
                              items:
                                type: object
                                x-apifox-refs:
                                  01J0Q497B9M5WGP7SNHD8Q4ARN: &ref_45
                                    $ref: '#/components/schemas/Discounts'
                                    x-apifox-overrides:
                                      invoice: null
                                      invoice_item: null
                                x-apifox-orders:
                                  - 01J0Q497B9M5WGP7SNHD8Q4ARN
                                properties:
                                  id:
                                    type: string
                                    description: >-
                                      The ID of the discount object. Discounts
                                      cannot be fetched by ID.
                                  object:
                                    type: string
                                    description: >-
                                      String representing the object’s type.
                                      Objects of the same type share the same
                                      value.
                                  checkout_session:
                                    type: string
                                    description: >-
                                      The Checkout session that this coupon is
                                      applied to, if it is applied to a
                                      particular session in payment mode. Will
                                      not be present for subscription mode.
                                  coupon:
                                    type: object
                                    x-apifox-refs:
                                      01HV3JTJ0FGTEWBDHHFJ74FZBE: &ref_6
                                        $ref: '#/components/schemas/Coupons'
                                        x-apifox-overrides:
                                          duration_in_weeks: null
                                          duration_in_months: null
                                          duration: null
                                          applies_to: null
                                    x-apifox-orders:
                                      - 01HV3JTJ0FGTEWBDHHFJ74FZBE
                                    properties:
                                      id:
                                        type: string
                                        description: Unique identifier for the object.
                                      amount_off:
                                        type: integer
                                        description: >-
                                          Amount (in the currency specified) that
                                          will be taken off the subtotal of any
                                          invoices for this customer.
                                        nullable: true
                                      currency:
                                        type: string
                                        description: >-
                                          If amount_off has been set, the
                                          three-letter ISO code for the currency
                                          of the amount to take off.
                                        nullable: true
                                      duration_in_days:
                                        type: string
                                        description: >-
                                          Required only if duration is repeating,
                                          in which case it must be a positive
                                          integer that specifies the number of
                                          weeks the discount will be in effect.
                                      object:
                                        type: string
                                        description: >-
                                          String representing the object’s type.
                                          Objects of the same type share the same
                                          value.
                                      created:
                                        type: integer
                                        description: >-
                                          Time at which the object was created.
                                          Measured in seconds since the Unix
                                          epoch.
                                      livemode:
                                        type: boolean
                                        description: >-
                                          Has the value true if the object exists
                                          in live mode or the value false if the
                                          object exists in test mode.
                                      metadata:
                                        type: object
                                        properties: {}
                                        x-apifox-orders: []
                                        description: >-
                                          Set of key-value pairs that you can
                                          attach to an object. This can be useful
                                          for storing additional information about
                                          the object in a structured format.
                                        x-apifox-ignore-properties: []
                                      name:
                                        type: string
                                        description: >-
                                          Name of the coupon displayed to
                                          customers on for instance invoices or
                                          receipts.
                                      percent_off:
                                        type: number
                                        description: >-
                                          Percent that will be taken off the
                                          subtotal of any invoices for this
                                          customer for the duration of the coupon.
                                          For example, a coupon with percent_off
                                          of 50 will make a $100 invoice $50
                                          instead.
                                        nullable: true
                                      max_redemptions:
                                        type: integer
                                        description: >-
                                          Maximum number of times this coupon can
                                          be redeemed, in total, across all
                                          customers, before it is no longer valid.
                                        nullable: true
                                      redeem_by:
                                        type: integer
                                        description: >-
                                          Date after which the coupon can no
                                          longer be redeemed.
                                        nullable: true
                                      times_redeemed:
                                        type: integer
                                        description: >-
                                          Number of times this coupon has been
                                          applied to a customer.
                                      valid:
                                        type: boolean
                                        description: >-
                                          Taking account of the above properties,
                                          whether this coupon can still be applied
                                          to a customer.
                                      currency_options:
                                        type: object
                                        properties:
                                          <currency>.amount_off:
                                            type: integer
                                            description: >-
                                              Amount (in the currency specified) that
                                              will be taken off the subtotal of any
                                              invoices for this customer.
                                        description: >-
                                          Coupons defined in each available
                                          currency option. Each key must be a
                                          three-letter ISO currency code and a
                                          supported currency.
                                        x-apifox-orders:
                                          - <currency>.amount_off
                                        x-apifox-ignore-properties: []
                                    description: >-
                                      Hash describing the coupon applied to
                                      create this discount.
                                    required:
                                      - duration_in_days
                                    x-apifox-ignore-properties:
                                      - id
                                      - amount_off
                                      - currency
                                      - duration_in_days
                                      - object
                                      - created
                                      - livemode
                                      - metadata
                                      - name
                                      - percent_off
                                      - max_redemptions
                                      - redeem_by
                                      - times_redeemed
                                      - valid
                                      - currency_options
                                  customer:
                                    type: string
                                    description: >-
                                      The ID of the customer associated with
                                      this discount.
                                  start:
                                    type: integer
                                    description: Date that the coupon was applied.
                                  end:
                                    type: 'null'
                                    description: >-
                                      If the coupon has a duration of repeating,
                                      the date that this discount will end. If
                                      the coupon has a duration of once or
                                      forever, this attribute will be null.
                                  promotion_code:
                                    type: 'null'
                                    description: >-
                                      The promotion code applied to create this
                                      discount.
                                  subscription:
                                    type: 'null'
                                    description: >-
                                      The subscription that this coupon is
                                      applied to, if it is applied to a
                                      particular subscription.
                                x-apifox-ignore-properties:
                                  - id
                                  - object
                                  - checkout_session
                                  - coupon
                                  - customer
                                  - start
                                  - end
                                  - promotion_code
                                  - subscription
                              description: The discounts applied to the line item.
                            amount_discount:
                              type: integer
                              description: >-
                                Total discount amount applied. If no discounts
                                were applied, defaults to 0.
                          x-apifox-ignore-properties:
                            - id
                            - object
                            - amount_subtotal
                            - amount_total
                            - currency
                            - description
                            - price
                            - quantity
                            - discounts
                            - amount_discount
                x-apifox-orders:
                  - 01GMQNR2HFET2WFY1YD89QM5HZ
                properties:
                  object: &ref_1
                    type: string
                    default: '"list"'
                  url: &ref_2
                    type: string
                  has_more: &ref_3
                    type: boolean
                  data:
                    type: array
                    items:
                      type: object
                      x-apifox-refs:
                        01GMQNRG4PSWM039172Y8J3G0A:
                          $ref: '#/components/schemas/Session'
                          x-apifox-overrides:
                            invoice: null
                            invoice_creation: null
                            setup_intent: null
                            shipping_cost: null
                            locale: null
                            consent: null
                            consent_collection: null
                            submit_type: null
                            custom_text: null
                            allow_promotion_codes: null
                            payment_method_collection: null
                            subscription: null
                            after_expiration: null
                            automatic_tax: null
                            total_details: null
                            recovered_from: null
                            customer_details: &ref_5
                              type: object
                              properties:
                                address:
                                  type: object
                                  properties:
                                    city:
                                      type: string
                                      description: >-
                                        City, district, suburb, town, or
                                        village.
                                      nullable: true
                                    country:
                                      type: string
                                      description: >-
                                        Two-letter country code (ISO 3166-1
                                        alpha-2 ).
                                      nullable: true
                                    line1:
                                      type: string
                                      description: >-
                                        Address line 1 (e.g., street, PO Box, or
                                        company name).
                                      nullable: true
                                    line2:
                                      type: string
                                      description: >-
                                        Address line 2 (e.g., apartment, suite,
                                        unit, or building).
                                      nullable: true
                                    postal_code:
                                      type: string
                                      description: ZIP or postal code.
                                      nullable: true
                                    state:
                                      type: string
                                      description: State, county, province, or region.
                                      nullable: true
                                  x-apifox-refs: {}
                                  x-apifox-orders:
                                    - city
                                    - country
                                    - line1
                                    - line2
                                    - postal_code
                                    - state
                                  description: >-
                                    The customer’s address after a completed
                                    Checkout Session.
                                  x-apifox-ignore-properties: []
                                email:
                                  type: string
                                  description: >-
                                    The email associated with the Customer, if
                                    one exists, on the Checkout Session after a
                                    completed Checkout Session or at time of
                                    session expiry.
                                  nullable: true
                                name:
                                  type: string
                                  description: >-
                                    The customer’s name after a completed
                                    Checkout Session. 
                                  nullable: true
                                phone:
                                  type: string
                                  description: >-
                                    The customer’s phone number after a
                                    completed Checkout Session.
                                  nullable: true
                              x-apifox-orders:
                                - address
                                - email
                                - name
                                - phone
                              description: P2
                              x-apifox-ignore-properties: []
                          required: []
                      x-apifox-orders:
                        - 01GMQNRG4PSWM039172Y8J3G0A
                      properties:
                        id:
                          type: string
                          description: >-
                            Unique identifier for the object, like "cs_xxx" in
                            live environment and "cs_test_xxx" in test
                            environment.
                        object:
                          type: string
                          description: value is "checkout.session"
                        amount_subtotal:
                          type: integer
                          description: >-
                            Total of all items before discounts or taxes are
                            applied.
                        amount_total:
                          type: integer
                          description: >-
                            Total of all items after discounts and taxes are
                            applied.
                        billing_address_collection:
                          type: string
                          description: >-
                            Describes whether Checkout should collect the
                            customer’s billing address.
                          enum:
                            - required
                            - auto
                          x-apifox-enum:
                            - value: required
                              name: ''
                              description: ''
                            - value: auto
                              name: ''
                              description: ''
                        cancel_url:
                          type: string
                          description: >-
                            The URL the customer will be directed to if they
                            decide to cancel payment and return to your website.
                        client_reference_id:
                          type: string
                          description: >-
                            A unique string to reference the Checkout Session.
                            This can be a customer ID, a cart ID, or similar,
                            and can be used to reconcile the Session with your
                            internal systems.
                        created:
                          type: integer
                          description: >-
                            Time at which the object was created. Measured in
                            seconds since the Unix epoch.
                        currency:
                          type: string
                          description: Three-letter ISO currency code
                        customer:
                          type: string
                          description: 'The ID of the customer for this Session. '
                        customer_email:
                          type: string
                          description: >-
                            If provided, this value will be used when the
                            Customer object is created. If not provided,
                            customers will be asked to enter their email
                            address. Use this parameter to prefill customer data
                            if you already have an email on file. To access
                            information about the customer once the payment flow
                            is complete, use the customer attribute.
                        expires_at:
                          type: integer
                          description: >-
                            The timestamp at which the Checkout Session will
                            expire. The Epoch time in seconds at which the
                            Checkout Session will expire. It can be anywhere
                            from 1 to 24 hours after Checkout Session creation.
                            By default, this value is 24 hours from creation.
                        livemode:
                          type: boolean
                          description: >-
                            Has the value true if the object exists in live mode
                            or the value false if the object exists in test
                            mode.
                        metadata:
                          type: object
                          properties: {}
                          x-apifox-orders: []
                          description: >-
                            Set of key-value pairs that you can attach to an
                            object. This can be useful for storing additional
                            information about the object in a structured format.
                          x-apifox-ignore-properties: []
                        mode:
                          type: string
                          description: >-
                            The mode of the Checkout Session. Only payment is
                            supported now.
                        payment_intent:
                          type: string
                          description: >-
                            The ID of the PaymentIntent for Checkout Sessions in
                            payment mode.
                        payment_link:
                          type: string
                          description: >-
                            The ID of the Payment Link that created this
                            Session.
                        payment_method_options: &ref_57
                          description: >-
                            Payment-method-specific configuration for the
                            PaymentIntent or SetupIntent of this
                            CheckoutSession.
                          $ref: '#/components/schemas/Payment%20Method%20Options'
                        payment_method_types:
                          type: array
                          items:
                            type: string
                          description: >-
                            A list of the types of payment methods (e.g. card)
                            this Checkout Session is allowed to accept.
                        payment_status:
                          type: string
                          description: >-
                            The payment status of the Checkout Session, one of
                            paid, unpaid, or no_payment_required. You can use
                            this value to decide when to fulfill your customer’s
                            order.
                        phone_number_collection:
                          type: object
                          properties:
                            enabled:
                              type: boolean
                              description: >-
                                Indicates whether phone number collection is
                                enabled for the session.
                          x-apifox-orders:
                            - enabled
                          description: >-
                            Details on the state of phone number collection for
                            the session. phone_number_collection.enabled boolean
                            Indicates whether phone number collection is enabled
                            for the session
                          x-apifox-ignore-properties: []
                        shipping_address_collection:
                          type: object
                          properties:
                            allowed_countries:
                              type: array
                              items:
                                type: string
                              description: >-
                                An array of two-letter ISO country codes
                                representing which countries Checkout should
                                provide as options for shipping locations. 
                          description: >-
                            When set, provides configuration for Checkout to
                            collect a shipping address from a customer.
                          x-apifox-orders:
                            - allowed_countries
                          x-apifox-ignore-properties: []
                        shipping:
                          description: Shipping information for this Checkout Session.
                          type: object
                          x-apifox-refs:
                            01GMQHM3R25RQHHK8GY2QSZHB6: &ref_58
                              $ref: '#/components/schemas/Shipping'
                              x-apifox-overrides: {}
                          x-apifox-orders:
                            - 01GMQHM3R25RQHHK8GY2QSZHB6
                          properties:
                            address: &ref_56
                              $ref: '#/components/schemas/Address'
                            carrier:
                              type: string
                              description: >-
                                The delivery service that shipped a physical
                                product, such as FedEx, UPS, USPS, etc. 
                            name:
                              type: string
                              description: 'Recipient name. '
                            phone:
                              type: string
                              description: 'Recipient phone (including extension). '
                            tracking_number:
                              type: string
                              description: >-
                                The tracking number for a physical product,
                                obtained from the delivery service. If multiple
                                tracking numbers were generated for this
                                purchase, please separate them with commas.
                          x-apifox-ignore-properties:
                            - address
                            - carrier
                            - name
                            - phone
                            - tracking_number
                        status:
                          type: string
                          description: >-
                            The status of the Checkout Session, one of open,
                            complete, or expired. 
                          enum:
                            - open
                            - complete
                            - expired
                          x-apifox-enum:
                            - value: open
                              name: ''
                              description: >-
                                The checkout session is still in progress.
                                Payment processing has not started
                            - value: complete
                              name: ''
                              description: >-
                                The checkout session is complete. Payment
                                processing may still be in progress.
                            - value: expired
                              name: ''
                              description: >-
                                The checkout session has expired. No further
                                processing will occur.
                        success_url:
                          type: string
                          description: >-
                            The URL the customer will be directed to after the
                            payment or subscription creation is successful.
                        url:
                          type: string
                          description: >-
                            The URL to the Checkout Session. Redirect customers
                            to this URL to take them to Checkout. 
                        line_items:
                          description: >-
                            The line items purchased by the customer. This field
                            is not included by default. To include it in the
                            response, expand the line_items field.
                          type: object
                          x-apifox-refs:
                            01GMQGBG5GSFNYSAE9WNRWXVS4: *ref_0
                          x-apifox-orders:
                            - 01GMQGBG5GSFNYSAE9WNRWXVS4
                          properties:
                            object: *ref_1
                            url: *ref_2
                            has_more: *ref_3
                            data: *ref_4
                          x-apifox-ignore-properties:
                            - object
                            - url
                            - has_more
                            - data
                        customer_creation:
                          type: string
                          description: >-
                            Configure whether a Checkout Session creates a
                            Customer when the Checkout Session completes. Can
                            only be set in payment and setup mode.
                          enum:
                            - always
                            - if_required
                          x-apifox-enum:
                            - value: always
                              name: ''
                              description: >-
                                The Checkout Session will always create a
                                Customer when a Session confirmation is
                                attempted.
                            - value: if_required
                              name: ''
                              description: >-
                                The Checkout Session will only create a Customer
                                if it is required for Session confirmation.
                                Currently, only subscription mode Sessions
                                require a Customer.
                        customer_details: *ref_5
                      x-apifox-ignore-properties:
                        - id
                        - object
                        - amount_subtotal
                        - amount_total
                        - billing_address_collection
                        - cancel_url
                        - client_reference_id
                        - created
                        - currency
                        - customer
                        - customer_email
                        - expires_at
                        - livemode
                        - metadata
                        - mode
                        - payment_intent
                        - payment_link
                        - payment_method_options
                        - payment_method_types
                        - payment_status
                        - phone_number_collection
                        - shipping_address_collection
                        - shipping
                        - status
                        - success_url
                        - url
                        - line_items
                        - customer_creation
                        - customer_details
                x-apifox-ignore-properties:
                  - object
                  - url
                  - has_more
                  - data
          headers: {}
          x-apifox-name: OK
      security:
        - basic: []
      x-apifox-folder: API Reference/Checkout
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/1296482/apis/api-42654191-run
components:
  schemas:
    List Request:
      type: object
      properties:
        created:
          type: object
          properties:
            gt:
              type: string
              description: >-
                Return results where the created field is greater than this
                value.
            gte:
              type: string
              description: >-
                Return results where the created field is greater than or equal
                to this value.
            lt:
              type: string
              description: Return results where the created field is less than this value.
            lte:
              type: string
              description: >-
                Return results where the created field is less than or equal to
                this value.
          description: >-
            A filter on the list based on the object created field. The value
            can be a string with an integer Unix timestamp, or it can be a
            dictionary with the following options:
          x-apifox-orders:
            - gt
            - gte
            - lt
            - lte
          x-apifox-ignore-properties: []
        ending_before:
          type: string
          description: >-
            A cursor for use in pagination. ending_before is an object ID that
            defines your place in the list. For instance, if you make a list
            request and receive 100 objects, starting with obj_bar, your
            subsequent call can include ending_before=obj_bar in order to fetch
            the previous page of the list.
        limit:
          type: integer
          description: >-
            A limit on the number of objects to be returned. Limit can range
            between 1 and 100, and the default is 10.
        starting_after:
          type: string
          description: >-
            A cursor for use in pagination. starting_after is an object ID that
            defines your place in the list. For instance, if you make a list
            request and receive 100 objects, ending with obj_foo, your
            subsequent call can include starting_after=obj_foo in order to fetch
            the next page of the list.
      x-apifox-orders:
        - created
        - ending_before
        - limit
        - starting_after
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    List:
      type: object
      properties:
        object: &ref_63
          type: string
          default: '"list"'
        url: &ref_64
          type: string
        has_more: &ref_65
          type: boolean
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              object:
                type: string
              api_version:
                type: 'null'
              application:
                type: 'null'
              created:
                type: integer
              description:
                type: string
              enabled_events:
                type: array
                items:
                  type: string
              livemode:
                type: boolean
              metadata:
                type: object
                properties: {}
                x-apifox-orders: []
                x-apifox-ignore-properties: []
              status:
                type: string
              url:
                type: string
            x-apifox-orders:
              - id
              - object
              - api_version
              - application
              - created
              - description
              - enabled_events
              - livemode
              - metadata
              - status
              - url
            x-apifox-ignore-properties: []
      x-apifox-orders:
        - object
        - url
        - has_more
        - data
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Coupons:
      type: object
      properties:
        id: &ref_7
          type: string
          description: Unique identifier for the object.
        amount_off: &ref_8
          type: integer
          description: >-
            Amount (in the currency specified) that will be taken off the
            subtotal of any invoices for this customer.
          nullable: true
        currency: &ref_9
          type: string
          description: >-
            If amount_off has been set, the three-letter ISO code for the
            currency of the amount to take off.
          nullable: true
        duration:
          type: string
          description: >-
            One of forever, once, and repeating. Describes how long a customer
            who applies this coupon will get the discount.
          enum:
            - forever
            - once
            - repeating
          x-apifox-enum:
            - value: forever
              name: ''
              description: >-
                Applies to all charges from a subscription with this coupon
                applied.
            - value: once
              name: ''
              description: >-
                Applies to the first charge from a subscription with this coupon
                applied.
            - value: repeating
              name: ''
              description: >-
                Applies to charges in the first duration_in_months months from a
                subscription with this coupon applied.
        duration_in_months:
          type: integer
          description: >-
            Required only if duration is repeating, in which case it must be a
            positive integer that specifies the number of months the discount
            will be in effect.
        duration_in_weeks:
          type: string
          description: >-
            Required only if duration is repeating, in which case it must be a
            positive integer that specifies the number of weeks the discount
            will be in effect.
        duration_in_days: &ref_10
          type: string
          description: >-
            Required only if duration is repeating, in which case it must be a
            positive integer that specifies the number of weeks the discount
            will be in effect.
        object: &ref_11
          type: string
          description: >-
            String representing the object’s type. Objects of the same type
            share the same value.
        created: &ref_12
          type: integer
          description: >-
            Time at which the object was created. Measured in seconds since the
            Unix epoch.
        livemode: &ref_13
          type: boolean
          description: >-
            Has the value true if the object exists in live mode or the value
            false if the object exists in test mode.
        metadata:
          type: object
          properties: {}
          x-apifox-orders: &ref_14 []
          description: >-
            Set of key-value pairs that you can attach to an object. This can be
            useful for storing additional information about the object in a
            structured format.
          x-apifox-ignore-properties: []
        name: &ref_15
          type: string
          description: >-
            Name of the coupon displayed to customers on for instance invoices
            or receipts.
        percent_off: &ref_16
          type: number
          description: >-
            Percent that will be taken off the subtotal of any invoices for this
            customer for the duration of the coupon. For example, a coupon with
            percent_off of 50 will make a $100 invoice $50 instead.
          nullable: true
        max_redemptions: &ref_17
          type: integer
          description: >-
            Maximum number of times this coupon can be redeemed, in total,
            across all customers, before it is no longer valid.
          nullable: true
        redeem_by: &ref_18
          type: integer
          description: Date after which the coupon can no longer be redeemed.
          nullable: true
        times_redeemed: &ref_19
          type: integer
          description: Number of times this coupon has been applied to a customer.
        valid: &ref_20
          type: boolean
          description: >-
            Taking account of the above properties, whether this coupon can
            still be applied to a customer.
        applies_to:
          type: object
          properties:
            products:
              type: array
              items:
                type: string
              description: A list of product IDs this coupon applies to
          description: Contains information about what this coupon applies to.
          x-apifox-orders:
            - products
          x-apifox-ignore-properties: []
        currency_options:
          type: object
          properties:
            <currency>.amount_off: &ref_21
              type: integer
              description: >-
                Amount (in the currency specified) that will be taken off the
                subtotal of any invoices for this customer.
          description: >-
            Coupons defined in each available currency option. Each key must be
            a three-letter ISO currency code and a supported currency.
          x-apifox-orders: &ref_22
            - <currency>.amount_off
          x-apifox-ignore-properties: []
      x-apifox-orders:
        - id
        - amount_off
        - currency
        - duration
        - duration_in_months
        - duration_in_weeks
        - duration_in_days
        - object
        - created
        - livemode
        - metadata
        - name
        - percent_off
        - max_redemptions
        - redeem_by
        - times_redeemed
        - valid
        - applies_to
        - currency_options
      required:
        - duration_in_weeks
        - duration_in_days
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Discounts:
      type: object
      properties:
        id: &ref_46
          type: string
          description: The ID of the discount object. Discounts cannot be fetched by ID.
        object: &ref_47
          type: string
          description: >-
            String representing the object’s type. Objects of the same type
            share the same value.
        checkout_session: &ref_48
          type: string
          description: >-
            The Checkout session that this coupon is applied to, if it is
            applied to a particular session in payment mode. Will not be present
            for subscription mode.
        coupon:
          type: object
          x-apifox-refs: &ref_49
            01HV3JTJ0FGTEWBDHHFJ74FZBE: *ref_6
          x-apifox-orders: &ref_50
            - 01HV3JTJ0FGTEWBDHHFJ74FZBE
          properties:
            id: *ref_7
            amount_off: *ref_8
            currency: *ref_9
            duration_in_days: *ref_10
            object: *ref_11
            created: *ref_12
            livemode: *ref_13
            metadata:
              type: object
              properties: {}
              x-apifox-orders: *ref_14
              description: >-
                Set of key-value pairs that you can attach to an object. This
                can be useful for storing additional information about the
                object in a structured format.
              x-apifox-ignore-properties: []
            name: *ref_15
            percent_off: *ref_16
            max_redemptions: *ref_17
            redeem_by: *ref_18
            times_redeemed: *ref_19
            valid: *ref_20
            currency_options:
              type: object
              properties:
                <currency>.amount_off: *ref_21
              description: >-
                Coupons defined in each available currency option. Each key must
                be a three-letter ISO currency code and a supported currency.
              x-apifox-orders: *ref_22
              x-apifox-ignore-properties: []
          description: Hash describing the coupon applied to create this discount.
          required:
            - duration_in_days
          x-apifox-ignore-properties:
            - id
            - amount_off
            - currency
            - duration_in_days
            - object
            - created
            - livemode
            - metadata
            - name
            - percent_off
            - max_redemptions
            - redeem_by
            - times_redeemed
            - valid
            - currency_options
        customer: &ref_51
          type: string
          description: The ID of the customer associated with this discount.
        start: &ref_52
          type: integer
          description: Date that the coupon was applied.
        end: &ref_53
          type: 'null'
          description: >-
            If the coupon has a duration of repeating, the date that this
            discount will end. If the coupon has a duration of once or forever,
            this attribute will be null.
        promotion_code: &ref_54
          type: 'null'
          description: The promotion code applied to create this discount.
        invoice:
          type: 'null'
          description: （未完成）
        invoice_item:
          type: 'null'
          description: （未完成）
        subscription: &ref_55
          type: 'null'
          description: >-
            The subscription that this coupon is applied to, if it is applied to
            a particular subscription.
      x-apifox-orders:
        - id
        - object
        - checkout_session
        - coupon
        - customer
        - start
        - end
        - promotion_code
        - invoice
        - invoice_item
        - subscription
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Price:
      type: object
      properties:
        id: &ref_24
          type: string
          description: Unique identifier for the object, like "price_xxxx".
        object: &ref_25
          type: string
          description: '''price'''
        active: &ref_26
          type: boolean
          description: Whether the price can be used for new purchases.
        billing_scheme:
          type: string
          description: >-
            Describes how to compute the price per period. Either per_unit or
            tiered
          enum: &ref_27
            - per_unit
            - tiered
          x-apifox-enum:
            - value: per_unit
              name: ''
              description: only per_unit is supported now.
            - value: tiered
              name: ''
              description: ''
        created: &ref_28
          type: integer
          description: >-
            Time at which the object was created. Measured in seconds since the
            Unix epoch.
        currency: &ref_29
          type: string
          description: 'Three-letter ISO currency code, in uppercase. '
        livemode: &ref_30
          type: boolean
          description: >-
            Has the value true if the object exists in live mode or the value
            false if the object exists in test mode.
        lookup_key: &ref_31
          type: string
          description: >-
            A lookup key used to retrieve prices dynamically from a static
            string. This may be up to 200 characters.
        metadata:
          type: object
          properties: {}
          x-apifox-orders: &ref_32 []
          description: >-
            Set of key-value pairs that you can attach to an object. This can be
            useful for storing additional information about the object in a
            structured format.
          x-apifox-ignore-properties: []
        nickname: &ref_33
          type: string
          description: A brief description of the price, hidden from customers.
        product: &ref_34
          type: string
          description: The ID of the product this price is associated with.
        type:
          type: string
          description: >-
            One of one_time or recurring depending on whether the price is for a
            one-time purchase or a recurring (subscription) purchase.
          enum: &ref_35
            - one_time
            - recurring
          x-apifox-enum:
            - value: one_time
              name: ''
              description: only one-time is supported now.
            - value: recurring
              name: ''
              description: ''
        unit_amount: &ref_36
          type: integer
          description: >-
            The unit amount in cents to be charged, represented as a whole
            integer if possible. Only set if billing_scheme=per_unit.
        custom_unit_amount:
          type: 'null'
          description: （未实现）
        recurring:
          type: object
          properties:
            interval:
              type: string
              description: >-
                The frequency at which a subscription is billed. One of day,
                week, month or year.
              enum: &ref_37
                - day
                - week
                - month
                - year
              x-apifox-enum:
                - value: day
                  name: ''
                  description: ''
                - value: week
                  name: ''
                  description: ''
                - value: month
                  name: ''
                  description: ''
                - value: year
                  name: ''
                  description: ''
            interval_count: &ref_38
              type: integer
              description: >-
                The number of intervals (specified in the interval attribute)
                between subscription billings. For example, interval=month and
                interval_count=3 bills every 3 months.
            usage_type:
              type: string
              description: Configures how the quantity per period should be determined.
              enum: &ref_39
                - licensed
              x-apifox-enum:
                - value: licensed
                  name: ''
                  description: ''
          x-apifox-orders: &ref_40
            - interval
            - interval_count
            - usage_type
          description: The recurring components of a price
          required:
            - interval
          x-apifox-ignore-properties: []
        tax_behavior:
          type: string
          description: （未实现）
        tiers_mode:
          type: 'null'
          description: （未实现）
        tiers:
          type: array
          items:
            type: object
            properties:
              up_to: &ref_41
                type: string
                description: >-
                  Specifies the upper bound of this tier. The lower bound of a
                  tier is the upper bound of the previous tier adding one. Use
                  inf to define a fallback tier.
              flat_amount: &ref_42
                type: string
                description: >-
                  The flat billing amount for an entire tier, regardless of the
                  number of units in the tier.
              unit_amount: &ref_43
                type: string
                description: >-
                  The per unit billing amount for each individual unit for which
                  this tier applies.
            x-apifox-orders: &ref_44
              - up_to
              - flat_amount
              - unit_amount
            x-apifox-ignore-properties: []
          description: （未实现）
        transform_quantity:
          type: 'null'
          description: （未实现）
        unit_amount_decimal:
          type: string
          description: （未实现）
      x-apifox-orders:
        - id
        - object
        - active
        - billing_scheme
        - created
        - currency
        - livemode
        - lookup_key
        - metadata
        - nickname
        - product
        - type
        - unit_amount
        - custom_unit_amount
        - recurring
        - tax_behavior
        - tiers_mode
        - tiers
        - transform_quantity
        - unit_amount_decimal
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    item:
      type: object
      properties:
        id: &ref_67
          type: string
          description: Unique identifier for the object, like "li_xxx"
        object: &ref_68
          type: string
          description: >-
            String representing the object’s type. Objects of the same type
            share the same value.
        amount_subtotal: &ref_69
          type: string
          description: Total before any discounts or taxes are applied.
        amount_total: &ref_70
          type: string
          description: Total after discounts and taxes.
        currency: &ref_71
          type: string
          description: Three-letter ISO currency code.
        description: &ref_72
          type: string
          description: >-
            An arbitrary string attached to the object. Often useful for
            displaying to users. Defaults to product name.
        price:
          type: object
          x-apifox-refs: &ref_73
            01GMQG5R25JKZG1CEB31ZYK9A1: *ref_23
          x-apifox-orders: &ref_74
            - 01GMQG5R25JKZG1CEB31ZYK9A1
          properties:
            id: *ref_24
            object: *ref_25
            active: *ref_26
            billing_scheme:
              type: string
              description: >-
                Describes how to compute the price per period. Either per_unit
                or tiered
              enum: *ref_27
              x-apifox-enum:
                - value: per_unit
                  name: ''
                  description: only per_unit is supported now.
                - value: tiered
                  name: ''
                  description: ''
            created: *ref_28
            currency: *ref_29
            livemode: *ref_30
            lookup_key: *ref_31
            metadata:
              type: object
              properties: {}
              x-apifox-orders: *ref_32
              description: >-
                Set of key-value pairs that you can attach to an object. This
                can be useful for storing additional information about the
                object in a structured format.
              x-apifox-ignore-properties: []
            nickname: *ref_33
            product: *ref_34
            type:
              type: string
              description: >-
                One of one_time or recurring depending on whether the price is
                for a one-time purchase or a recurring (subscription) purchase.
              enum: *ref_35
              x-apifox-enum:
                - value: one_time
                  name: ''
                  description: only one-time is supported now.
                - value: recurring
                  name: ''
                  description: ''
            unit_amount: *ref_36
            recurring:
              type: object
              properties:
                interval:
                  type: string
                  description: >-
                    The frequency at which a subscription is billed. One of day,
                    week, month or year.
                  enum: *ref_37
                  x-apifox-enum:
                    - value: day
                      name: ''
                      description: ''
                    - value: week
                      name: ''
                      description: ''
                    - value: month
                      name: ''
                      description: ''
                    - value: year
                      name: ''
                      description: ''
                interval_count: *ref_38
                usage_type:
                  type: string
                  description: Configures how the quantity per period should be determined.
                  enum: *ref_39
                  x-apifox-enum:
                    - value: licensed
                      name: ''
                      description: ''
              x-apifox-orders: *ref_40
              description: The recurring components of a price
              required:
                - interval
              x-apifox-ignore-properties: []
            tiers:
              type: array
              items:
                type: object
                properties:
                  up_to: *ref_41
                  flat_amount: *ref_42
                  unit_amount: *ref_43
                x-apifox-orders: *ref_44
                x-apifox-ignore-properties: []
              description: （未实现）
          description: The price used to generate the line item.
          x-apifox-ignore-properties:
            - id
            - object
            - active
            - billing_scheme
            - created
            - currency
            - livemode
            - lookup_key
            - metadata
            - nickname
            - product
            - type
            - unit_amount
            - recurring
            - tiers
        quantity: &ref_75
          type: string
          description: The quantity of products being purchased.
        taxes:
          type: string
          description: （未实现）The taxes applied to the line item.
        discounts:
          type: array
          items:
            type: object
            x-apifox-refs: &ref_76
              01J0Q497B9M5WGP7SNHD8Q4ARN: *ref_45
            x-apifox-orders: &ref_77
              - 01J0Q497B9M5WGP7SNHD8Q4ARN
            properties:
              id: *ref_46
              object: *ref_47
              checkout_session: *ref_48
              coupon:
                type: object
                x-apifox-refs: *ref_49
                x-apifox-orders: *ref_50
                properties:
                  id: *ref_7
                  amount_off: *ref_8
                  currency: *ref_9
                  duration_in_days: *ref_10
                  object: *ref_11
                  created: *ref_12
                  livemode: *ref_13
                  metadata:
                    type: object
                    properties: {}
                    x-apifox-orders: *ref_14
                    description: >-
                      Set of key-value pairs that you can attach to an object.
                      This can be useful for storing additional information
                      about the object in a structured format.
                    x-apifox-ignore-properties: []
                  name: *ref_15
                  percent_off: *ref_16
                  max_redemptions: *ref_17
                  redeem_by: *ref_18
                  times_redeemed: *ref_19
                  valid: *ref_20
                  currency_options:
                    type: object
                    properties:
                      <currency>.amount_off: *ref_21
                    description: >-
                      Coupons defined in each available currency option. Each
                      key must be a three-letter ISO currency code and a
                      supported currency.
                    x-apifox-orders: *ref_22
                    x-apifox-ignore-properties: []
                description: Hash describing the coupon applied to create this discount.
                required:
                  - duration_in_days
                x-apifox-ignore-properties:
                  - id
                  - amount_off
                  - currency
                  - duration_in_days
                  - object
                  - created
                  - livemode
                  - metadata
                  - name
                  - percent_off
                  - max_redemptions
                  - redeem_by
                  - times_redeemed
                  - valid
                  - currency_options
              customer: *ref_51
              start: *ref_52
              end: *ref_53
              promotion_code: *ref_54
              subscription: *ref_55
            x-apifox-ignore-properties:
              - id
              - object
              - checkout_session
              - coupon
              - customer
              - start
              - end
              - promotion_code
              - subscription
          description: The discounts applied to the line item.
        amount_discount: &ref_78
          type: integer
          description: >-
            Total discount amount applied. If no discounts were applied,
            defaults to 0.
        amount_tax:
          type: string
          description: （未实现）Total tax amount applied. If no tax was applied, defaults to 0.
      x-apifox-orders:
        - id
        - object
        - amount_subtotal
        - amount_total
        - currency
        - description
        - price
        - quantity
        - taxes
        - discounts
        - amount_discount
        - amount_tax
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Address:
      type: object
      properties:
        city:
          type: string
          description: City, district, suburb, town, or village.
        country:
          type: string
          description: Two-letter country code (ISO 3166-1 alpha-2 ).
        line1:
          type: string
          description: Address line 1 (e.g., street, PO Box, or company name).
        line2:
          type: string
          description: Address line 2 (e.g., apartment, suite, unit, or building).
        postal_code:
          type: string
          description: ZIP or postal code.
        state:
          type: string
          description: State, county, province, or region.
      x-apifox-orders:
        - city
        - country
        - line1
        - line2
        - postal_code
        - state
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Shipping:
      type: object
      properties:
        address: *ref_56
        carrier: &ref_59
          type: string
          description: >-
            The delivery service that shipped a physical product, such as FedEx,
            UPS, USPS, etc. 
        name: &ref_60
          type: string
          description: 'Recipient name. '
        phone: &ref_61
          type: string
          description: 'Recipient phone (including extension). '
        tracking_number: &ref_62
          type: string
          description: >-
            The tracking number for a physical product, obtained from the
            delivery service. If multiple tracking numbers were generated for
            this purchase, please separate them with commas.
      x-apifox-orders:
        - address
        - carrier
        - name
        - phone
        - tracking_number
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Payment Method Options:
      type: object
      properties:
        card:
          type: object
          properties:
            request_three_d_secure:
              type: string
              description: >-
                Values can be auto, any, void When a user selects the void
                option, Wooshpay will still perform 3DS if it encounters a
                policy.
              enum:
                - any
                - auto
                - void
              x-apifox-enum:
                - value: any
                  name: ''
                  description: Use any to request 3DS with a preference for 3ds flow
                - value: auto
                  name: ''
                  description: >-
                    (Default) Our SCA Engine automatically prompts your
                    customers for authentication based on risk level and other
                    requirements.
                - value: void
                  name: ''
                  description: Do not prefer the 3ds flow
            setup_future_usage:
              type: string
              description: >-
                Indicates that you intend to make future payments with this
                PaymentIntent’s payment method. Providing this parameter will
                attach the payment method to the PaymentIntent’s Customer, if
                present, after the PaymentIntent is confirmed and any required
                actions from the user are complete.
              enum:
                - on_session
                - off_session
                - none
              x-apifox-enum:
                - value: on_session
                  name: ''
                  description: >-
                    if you intend to only reuse the payment method when your
                    customer is present in your checkout flow.
                - value: off_session
                  name: ''
                  description: ' if your customer may or may not be present in your checkout flow.'
                - value: none
                  name: ''
                  description: >-
                    if you do not intend to reuse this payment method and want
                    to override the top-level setup_future_usage value for this
                    payment method.
            capture_method:
              type: string
              description: >-
                Controls when the funds will be captured from the customer’s
                account. If capture_method is already set on the PaymentIntent,
                providing an empty value for this parameter will unset the
                stored value for this payment method type.
            tax_id:
              type: string
          x-apifox-orders:
            - request_three_d_secure
            - setup_future_usage
            - capture_method
            - tax_id
          x-apifox-ignore-properties: []
        alipayplus:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
              enum:
                - APP
                - WAP
                - WEB
              x-apifox-enum:
                - value: APP
                  name: ''
                  description: ''
                - value: WAP
                  name: ''
                  description: ''
                - value: WEB
                  name: ''
                  description: ''
            os_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
              enum:
                - IOS
                - ANDROID
              x-apifox-enum:
                - value: IOS
                  name: ''
                  description: ''
                - value: ANDROID
                  name: ''
                  description: ''
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        alipay_hk:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
              enum:
                - APP
                - WAP
                - WEB
              x-apifox-enum:
                - value: APP
                  name: ''
                  description: ''
                - value: WAP
                  name: ''
                  description: ''
                - value: WEB
                  name: ''
                  description: ''
            os_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
              enum:
                - IOS
                - ANDROID
              x-apifox-enum:
                - value: IOS
                  name: ''
                  description: ''
                - value: ANDROID
                  name: ''
                  description: ''
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        alipay:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
              enum:
                - APP
                - WAP
                - WEB
              x-apifox-enum:
                - value: APP
                  name: ''
                  description: ''
                - value: WAP
                  name: ''
                  description: ''
                - value: WEB
                  name: ''
                  description: ''
            os_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
              enum:
                - IOS
                - ANDROID
              x-apifox-enum:
                - value: IOS
                  name: ''
                  description: ''
                - value: ANDROID
                  name: ''
                  description: ''
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        wechat_pay:
          type: object
          properties:
            terminal_type:
              type: string
              enum:
                - WEB
                - SCAN_CODE
                - WAP
                - OFFICIAL_ACCOUNT
              description: |-
                enum:"WEB","WAP","SCAN_CODE","OFFICIAL_ACCOUNT".
                "WEB": QR Code Payment
                "WAP": H5 Payment
                "SCAN_CODE": Quick Pay
                "OFFICIAL_ACCOUNT":Official Account Payment
              x-apifox-enum:
                - value: WEB
                  name: ''
                  description: >-
                    Users use WeChat's "Scan" feature to scan a payment code
                    generated by a merchant on a web page to make a payment.
                - value: SCAN_CODE
                  name: ''
                  description: Users present their WeChat Pay payment code to the merchant
                - value: WAP
                  name: ''
                  description: Users make purchases in merchant apps using WeChat Pay.
                - value: OFFICIAL_ACCOUNT
                  name: ''
                  description: ''
            client_ip:
              type: string
            os_type:
              type: string
              enum:
                - IOS
                - ANDROID
              x-apifox-enum:
                - value: IOS
                  name: ''
                  description: ''
                - value: ANDROID
                  name: ''
                  description: ''
            openid:
              type: string
              description: user's identification in the WeChat official account
          x-apifox-orders:
            - terminal_type
            - client_ip
            - os_type
            - openid
          x-apifox-ignore-properties: []
        sepa_debit:
          type: object
          properties: {}
          x-apifox-orders: []
          x-apifox-ignore-properties: []
        akulaku:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
              enum:
                - WEB
                - WAP
                - APP
                - MINI_APP
              x-apifox-enum:
                - value: WEB
                  name: ''
                  description: ''
                - value: WAP
                  name: ''
                  description: ''
                - value: APP
                  name: ''
                  description: ''
                - value: MINI_APP
                  name: ''
                  description: ''
            os_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
              enum:
                - IOS
                - ANDROID
              x-apifox-enum:
                - value: IOS
                  name: ''
                  description: ''
                - value: ANDROID
                  name: ''
                  description: ''
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        truemoney:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
              enum:
                - WEB
                - WAP
                - APP
                - MINI_APP
              x-apifox-enum:
                - value: WEB
                  name: ''
                  description: ''
                - value: WAP
                  name: ''
                  description: ''
                - value: APP
                  name: ''
                  description: ''
                - value: MINI_APP
                  name: ''
                  description: ''
            os_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
              enum:
                - IOS
                - ANDROID
              x-apifox-enum:
                - value: IOS
                  name: ''
                  description: ''
                - value: ANDROID
                  name: ''
                  description: ''
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        kakaopay:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
              enum:
                - WEB
                - WAP
                - APP
                - MINI_APP
              x-apifox-enum:
                - value: WEB
                  name: ''
                  description: ''
                - value: WAP
                  name: ''
                  description: ''
                - value: APP
                  name: ''
                  description: ''
                - value: MINI_APP
                  name: ''
                  description: ''
            os_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
              enum:
                - IOS
                - ANDROID
              x-apifox-enum:
                - value: IOS
                  name: ''
                  description: ''
                - value: ANDROID
                  name: ''
                  description: ''
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        shopeepay:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
            os_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        dana:
          type: object
          properties:
            terminal_type:
              type: string
              description: >-
                enum:"WEB","WAP","APP","MINI_APP". WEB: indicates that a PC
                browser is used.WAP: indicates that a mobile browser is
                used.APP: indicates that a mobile app is used.MINI_APP:
                indicates that a mini program is used.
            os_type:
              type: string
              description: >-
                enum:"IOS", "ANDROID". os_type is required if terminal_type is
                "APP" or "WAP"
          x-apifox-orders:
            - terminal_type
            - os_type
          x-apifox-ignore-properties: []
        pix:
          type: object
          properties:
            tax_id:
              type: string
          x-apifox-orders:
            - tax_id
          required:
            - tax_id
          x-apifox-ignore-properties: []
      x-apifox-orders:
        - card
        - alipayplus
        - alipay_hk
        - alipay
        - wechat_pay
        - sepa_debit
        - akulaku
        - truemoney
        - kakaopay
        - shopeepay
        - dana
        - pix
      description: Payment-method-specific configuration for this PaymentIntent.
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    Session:
      type: object
      properties:
        id:
          type: string
          description: >-
            Unique identifier for the object, like "cs_xxx" in live environment
            and "cs_test_xxx" in test environment.
        object:
          type: string
          description: value is "checkout.session"
        amount_subtotal:
          type: integer
          description: Total of all items before discounts or taxes are applied.
        amount_total:
          type: integer
          description: Total of all items after discounts and taxes are applied.
        billing_address_collection:
          type: string
          description: >-
            Describes whether Checkout should collect the customer’s billing
            address.
          enum:
            - required
            - auto
          x-apifox-enum:
            - value: required
              name: ''
              description: ''
            - value: auto
              name: ''
              description: ''
        cancel_url:
          type: string
          description: >-
            The URL the customer will be directed to if they decide to cancel
            payment and return to your website.
        client_reference_id:
          type: string
          description: >-
            A unique string to reference the Checkout Session. This can be a
            customer ID, a cart ID, or similar, and can be used to reconcile the
            Session with your internal systems.
        created:
          type: integer
          description: >-
            Time at which the object was created. Measured in seconds since the
            Unix epoch.
        currency:
          type: string
          description: Three-letter ISO currency code
        customer:
          type: string
          description: 'The ID of the customer for this Session. '
        customer_email:
          type: string
          description: >-
            If provided, this value will be used when the Customer object is
            created. If not provided, customers will be asked to enter their
            email address. Use this parameter to prefill customer data if you
            already have an email on file. To access information about the
            customer once the payment flow is complete, use the customer
            attribute.
        expires_at:
          type: integer
          description: >-
            The timestamp at which the Checkout Session will expire. The Epoch
            time in seconds at which the Checkout Session will expire. It can be
            anywhere from 1 to 24 hours after Checkout Session creation. By
            default, this value is 24 hours from creation.
        livemode:
          type: boolean
          description: >-
            Has the value true if the object exists in live mode or the value
            false if the object exists in test mode.
        metadata:
          type: object
          properties: {}
          x-apifox-orders: []
          description: >-
            Set of key-value pairs that you can attach to an object. This can be
            useful for storing additional information about the object in a
            structured format.
          x-apifox-ignore-properties: []
        mode:
          type: string
          description: The mode of the Checkout Session. Only payment is supported now.
        payment_intent:
          type: string
          description: The ID of the PaymentIntent for Checkout Sessions in payment mode.
        payment_link:
          type: string
          description: The ID of the Payment Link that created this Session.
        payment_method_options: *ref_57
        payment_method_types:
          type: array
          items:
            type: string
          description: >-
            A list of the types of payment methods (e.g. card) this Checkout
            Session is allowed to accept.
        payment_status:
          type: string
          description: >-
            The payment status of the Checkout Session, one of paid, unpaid, or
            no_payment_required. You can use this value to decide when to
            fulfill your customer’s order.
        phone_number_collection:
          type: object
          properties:
            enabled:
              type: boolean
              description: >-
                Indicates whether phone number collection is enabled for the
                session.
          x-apifox-orders:
            - enabled
          description: >-
            Details on the state of phone number collection for the session.
            phone_number_collection.enabled boolean Indicates whether phone
            number collection is enabled for the session
          x-apifox-ignore-properties: []
        shipping_address_collection:
          type: object
          properties:
            allowed_countries:
              type: array
              items:
                type: string
              description: >-
                An array of two-letter ISO country codes representing which
                countries Checkout should provide as options for shipping
                locations. 
          description: >-
            When set, provides configuration for Checkout to collect a shipping
            address from a customer.
          x-apifox-orders:
            - allowed_countries
          x-apifox-ignore-properties: []
        shipping:
          description: Shipping information for this Checkout Session.
          type: object
          x-apifox-refs:
            01GMQHM3R25RQHHK8GY2QSZHB6: *ref_58
          x-apifox-orders:
            - 01GMQHM3R25RQHHK8GY2QSZHB6
          properties:
            address: *ref_56
            carrier: *ref_59
            name: *ref_60
            phone: *ref_61
            tracking_number: *ref_62
          x-apifox-ignore-properties:
            - address
            - carrier
            - name
            - phone
            - tracking_number
        status:
          type: string
          description: >-
            The status of the Checkout Session, one of open, complete, or
            expired. 
          enum:
            - open
            - complete
            - expired
          x-apifox-enum:
            - value: open
              name: ''
              description: >-
                The checkout session is still in progress. Payment processing
                has not started
            - value: complete
              name: ''
              description: >-
                The checkout session is complete. Payment processing may still
                be in progress.
            - value: expired
              name: ''
              description: >-
                The checkout session has expired. No further processing will
                occur.
        success_url:
          type: string
          description: >-
            The URL the customer will be directed to after the payment or
            subscription creation is successful.
        url:
          type: string
          description: >-
            The URL to the Checkout Session. Redirect customers to this URL to
            take them to Checkout. 
        line_items:
          description: >-
            The line items purchased by the customer. This field is not included
            by default. To include it in the response, expand the line_items
            field.
          type: object
          x-apifox-refs:
            01GMQGBG5GSFNYSAE9WNRWXVS4: *ref_0
          x-apifox-orders:
            - 01GMQGBG5GSFNYSAE9WNRWXVS4
          properties:
            object: *ref_63
            url: *ref_64
            has_more: *ref_65
            data:
              type: array
              items:
                type: object
                x-apifox-refs:
                  01GMQGC5BJT0A3P7BG6BZD73SD: *ref_66
                x-apifox-orders:
                  - 01GMQGC5BJT0A3P7BG6BZD73SD
                properties:
                  id: *ref_67
                  object: *ref_68
                  amount_subtotal: *ref_69
                  amount_total: *ref_70
                  currency: *ref_71
                  description: *ref_72
                  price:
                    type: object
                    x-apifox-refs: *ref_73
                    x-apifox-orders: *ref_74
                    properties:
                      id: *ref_24
                      object: *ref_25
                      active: *ref_26
                      billing_scheme:
                        type: string
                        description: >-
                          Describes how to compute the price per period. Either
                          per_unit or tiered
                        enum: *ref_27
                        x-apifox-enum:
                          - value: per_unit
                            name: ''
                            description: only per_unit is supported now.
                          - value: tiered
                            name: ''
                            description: ''
                      created: *ref_28
                      currency: *ref_29
                      livemode: *ref_30
                      lookup_key: *ref_31
                      metadata:
                        type: object
                        properties: {}
                        x-apifox-orders: *ref_32
                        description: >-
                          Set of key-value pairs that you can attach to an
                          object. This can be useful for storing additional
                          information about the object in a structured format.
                        x-apifox-ignore-properties: []
                      nickname: *ref_33
                      product: *ref_34
                      type:
                        type: string
                        description: >-
                          One of one_time or recurring depending on whether the
                          price is for a one-time purchase or a recurring
                          (subscription) purchase.
                        enum: *ref_35
                        x-apifox-enum:
                          - value: one_time
                            name: ''
                            description: only one-time is supported now.
                          - value: recurring
                            name: ''
                            description: ''
                      unit_amount: *ref_36
                      recurring:
                        type: object
                        properties:
                          interval:
                            type: string
                            description: >-
                              The frequency at which a subscription is billed.
                              One of day, week, month or year.
                            enum: *ref_37
                            x-apifox-enum:
                              - value: day
                                name: ''
                                description: ''
                              - value: week
                                name: ''
                                description: ''
                              - value: month
                                name: ''
                                description: ''
                              - value: year
                                name: ''
                                description: ''
                          interval_count: *ref_38
                          usage_type:
                            type: string
                            description: >-
                              Configures how the quantity per period should be
                              determined.
                            enum: *ref_39
                            x-apifox-enum:
                              - value: licensed
                                name: ''
                                description: ''
                        x-apifox-orders: *ref_40
                        description: The recurring components of a price
                        required:
                          - interval
                        x-apifox-ignore-properties: []
                      tiers:
                        type: array
                        items:
                          type: object
                          properties:
                            up_to: *ref_41
                            flat_amount: *ref_42
                            unit_amount: *ref_43
                          x-apifox-orders: *ref_44
                          x-apifox-ignore-properties: []
                        description: （未实现）
                    description: The price used to generate the line item.
                    x-apifox-ignore-properties:
                      - id
                      - object
                      - active
                      - billing_scheme
                      - created
                      - currency
                      - livemode
                      - lookup_key
                      - metadata
                      - nickname
                      - product
                      - type
                      - unit_amount
                      - recurring
                      - tiers
                  quantity: *ref_75
                  discounts:
                    type: array
                    items:
                      type: object
                      x-apifox-refs: *ref_76
                      x-apifox-orders: *ref_77
                      properties:
                        id: *ref_46
                        object: *ref_47
                        checkout_session: *ref_48
                        coupon:
                          type: object
                          x-apifox-refs: *ref_49
                          x-apifox-orders: *ref_50
                          properties:
                            id: *ref_7
                            amount_off: *ref_8
                            currency: *ref_9
                            duration_in_days: *ref_10
                            object: *ref_11
                            created: *ref_12
                            livemode: *ref_13
                            metadata:
                              type: object
                              properties: {}
                              x-apifox-orders: *ref_14
                              description: >-
                                Set of key-value pairs that you can attach to an
                                object. This can be useful for storing
                                additional information about the object in a
                                structured format.
                              x-apifox-ignore-properties: []
                            name: *ref_15
                            percent_off: *ref_16
                            max_redemptions: *ref_17
                            redeem_by: *ref_18
                            times_redeemed: *ref_19
                            valid: *ref_20
                            currency_options:
                              type: object
                              properties:
                                <currency>.amount_off: *ref_21
                              description: >-
                                Coupons defined in each available currency
                                option. Each key must be a three-letter ISO
                                currency code and a supported currency.
                              x-apifox-orders: *ref_22
                              x-apifox-ignore-properties: []
                          description: >-
                            Hash describing the coupon applied to create this
                            discount.
                          required:
                            - duration_in_days
                          x-apifox-ignore-properties:
                            - id
                            - amount_off
                            - currency
                            - duration_in_days
                            - object
                            - created
                            - livemode
                            - metadata
                            - name
                            - percent_off
                            - max_redemptions
                            - redeem_by
                            - times_redeemed
                            - valid
                            - currency_options
                        customer: *ref_51
                        start: *ref_52
                        end: *ref_53
                        promotion_code: *ref_54
                        subscription: *ref_55
                      x-apifox-ignore-properties:
                        - id
                        - object
                        - checkout_session
                        - coupon
                        - customer
                        - start
                        - end
                        - promotion_code
                        - subscription
                    description: The discounts applied to the line item.
                  amount_discount: *ref_78
                x-apifox-ignore-properties:
                  - id
                  - object
                  - amount_subtotal
                  - amount_total
                  - currency
                  - description
                  - price
                  - quantity
                  - discounts
                  - amount_discount
          x-apifox-ignore-properties:
            - object
            - url
            - has_more
            - data
        subscription:
          type: string
          description: >-
            The ID of the subscription for Checkout Sessions in subscription
            mode.
          nullable: true
        allow_promotion_codes:
          type: boolean
          description: Enables user redeemable promotion codes.
        recovered_from:
          type: 'null'
          description: （未实现）
        total_details:
          type: 'null'
          description: （未实现）
        automatic_tax:
          type: object
          properties:
            enabled:
              type: boolean
            status:
              type: 'null'
          x-apifox-orders:
            - enabled
            - status
          description: （未实现）
          x-apifox-ignore-properties: []
        after_expiration:
          type: 'null'
          description: （未实现）
        payment_method_collection:
          type: 'null'
          description: （未实现）
        custom_text:
          type: object
          properties:
            shipping_address:
              type: 'null'
            submit:
              type: 'null'
          x-apifox-orders:
            - shipping_address
            - submit
          description: （未实现）
          x-apifox-ignore-properties: []
        submit_type:
          type: 'null'
          description: （未实现）
        consent_collection:
          type: 'null'
          description: （未实现）
        consent:
          type: 'null'
          description: （未实现）
        locale:
          type: 'null'
          description: （未实现）
        shipping_cost:
          type: 'null'
          description: （未实现）
        setup_intent:
          type: 'null'
          description: （未实现）
        invoice_creation:
          type: 'null'
          description: （未实现）
        invoice:
          type: 'null'
          description: （未实现）
        customer_creation:
          type: string
          description: >-
            Configure whether a Checkout Session creates a Customer when the
            Checkout Session completes. Can only be set in payment and setup
            mode.
          enum:
            - always
            - if_required
          x-apifox-enum:
            - value: always
              name: ''
              description: >-
                The Checkout Session will always create a Customer when a
                Session confirmation is attempted.
            - value: if_required
              name: ''
              description: >-
                The Checkout Session will only create a Customer if it is
                required for Session confirmation. Currently, only subscription
                mode Sessions require a Customer.
        customer_details:
          type: object
          properties:
            address:
              type: object
              properties:
                city:
                  type: string
                  description: City, district, suburb, town, or village.
                  nullable: true
                country:
                  type: string
                  description: Two-letter country code (ISO 3166-1 alpha-2 ).
                  nullable: true
                line1:
                  type: string
                  description: Address line 1 (e.g., street, PO Box, or company name).
                  nullable: true
                line2:
                  type: string
                  description: Address line 2 (e.g., apartment, suite, unit, or building).
                  nullable: true
                postal_code:
                  type: string
                  description: ZIP or postal code.
                  nullable: true
                state:
                  type: string
                  description: State, county, province, or region.
                  nullable: true
              x-apifox-refs: {}
              x-apifox-orders:
                - city
                - country
                - line1
                - line2
                - postal_code
                - state
              description: The customer’s address after a completed Checkout Session.
              x-apifox-ignore-properties: []
            email:
              type: string
              description: >-
                The email associated with the Customer, if one exists, on the
                Checkout Session after a completed Checkout Session or at time
                of session expiry.
              nullable: true
            name:
              type: string
              description: 'The customer’s name after a completed Checkout Session. '
              nullable: true
            phone:
              type: string
              description: The customer’s phone number after a completed Checkout Session.
              nullable: true
            tax_exempt:
              type: string
            tax_ids:
              type: 'null'
          x-apifox-orders:
            - address
            - email
            - name
            - phone
            - tax_exempt
            - tax_ids
          x-apifox-ignore-properties: []
      x-apifox-orders:
        - id
        - object
        - amount_subtotal
        - amount_total
        - billing_address_collection
        - cancel_url
        - client_reference_id
        - created
        - currency
        - customer
        - customer_email
        - expires_at
        - livemode
        - metadata
        - mode
        - payment_intent
        - payment_link
        - payment_method_options
        - payment_method_types
        - payment_status
        - phone_number_collection
        - shipping_address_collection
        - shipping
        - status
        - success_url
        - url
        - line_items
        - subscription
        - allow_promotion_codes
        - recovered_from
        - total_details
        - automatic_tax
        - after_expiration
        - payment_method_collection
        - custom_text
        - submit_type
        - consent_collection
        - consent
        - locale
        - shipping_cost
        - setup_intent
        - invoice_creation
        - invoice
        - customer_creation
        - customer_details
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    basic:
      type: http
      scheme: basic
servers:
  - url: https://apitest.wooshpay.com
    description: 官网测试
security:
  - basic: []

```
