> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List payments

> Returns a paginated list of payments for the actor in context, with optional filtering by product, plan, status, billing reason, currency, and creation date.

Required permissions:
 - `payment:basic:read`
 - `plan:basic:read`
 - `access_pass:basic:read`
 - `member:email:read`
 - `member:basic:read`
 - `member:phone:read`
 - `promo_code:basic:read`



## OpenAPI

````yaml /openapi/api-v1-stable.json get /payments
openapi: 3.1.0
info:
  description: >-
    The Whop REST API. Please see
    https://docs.whop.com/developer/api/getting-started for more details.
  termsOfService: https://whop.com/tos-developer-api/
  title: Whop API
  version: 1.0.0
  x-api-version-date: '2026-07-20'
servers:
  - description: Production Whop API
    url: https://api.whop.com/api/v1
  - description: Sandbox Whop API
    url: https://sandbox-api.whop.com/api/v1
security: []
tags:
  - description: Products
    name: Products
  - description: Payments
    name: Payments
  - description: Refunds
    name: Refunds
  - description: Disputes
    name: Disputes
  - description: Dispute alerts
    name: Dispute alerts
  - description: Resolution center cases
    name: Resolution center cases
  - description: Checkout configurations
    name: Checkout configurations
  - description: Setup intents
    name: Setup intents
  - description: Payment methods
    name: Payment methods
  - description: Invoices
    name: Invoices
  - description: Promo codes
    name: Promo codes
  - description: Card transactions
    name: Card transactions
  - description: Ledger accounts
    name: Ledger accounts
  - description: Withdrawals
    name: Withdrawals
  - description: Payout methods
    name: Payout methods
  - description: Verifications
    name: Verifications
  - description: Identity profiles
    name: Identity profiles
  - description: Payout accounts
    name: Payout accounts
  - description: Topups
    name: Topups
  - description: Companies
    name: Companies
  - description: Authorized users
    name: Authorized users
  - description: Fee markups
    name: Fee markups
  - description: Members
    name: Members
  - description: Memberships
    name: Memberships
  - description: Leads
    name: Leads
  - description: Entries
    name: Entries
  - description: Shipments
    name: Shipments
  - description: Reviews
    name: Reviews
  - description: Company token transactions
    name: Company token transactions
  - description: Affiliates
    name: Affiliates
  - description: Experiences
    name: Experiences
  - description: Forums
    name: Forums
  - description: Forum posts
    name: Forum posts
  - description: Chat channels
    name: Chat channels
  - description: Support channels
    name: Support channels
  - description: Messages
    name: Messages
  - description: Reactions
    name: Reactions
  - description: Dm members
    name: Dm members
  - description: Dm channels
    name: Dm channels
  - description: Notifications
    name: Notifications
  - description: Courses
    name: Courses
  - description: Course chapters
    name: Course chapters
  - description: Course lessons
    name: Course lessons
  - description: Course students
    name: Course students
  - description: Course lesson interactions
    name: Course lesson interactions
  - description: Apps
    name: Apps
  - description: Webhooks
    name: Webhooks
  - description: App builds
    name: App builds
  - description: Access tokens
    name: Access tokens
  - description: Account links
    name: Account links
  - description: Files
    name: Files
  - description: Ai chats
    name: Ai chats
  - description: Bounties
    name: Bounties
  - description: Stats
    name: Stats
  - description: Conversions
    name: Conversions
  - description: Ad reports
    name: Ad reports
paths:
  /payments:
    get:
      tags:
        - Payments
      summary: List payments
      description: >-
        Returns a paginated list of payments for the actor in context, with
        optional filtering by product, plan, status, billing reason, currency,
        and creation date.


        Required permissions:
         - `payment:basic:read`
         - `plan:basic:read`
         - `access_pass:basic:read`
         - `member:email:read`
         - `member:basic:read`
         - `member:phone:read`
         - `promo_code:basic:read`
      operationId: listPayment
      parameters:
        - explode: true
          in: query
          name: after
          required: false
          schema:
            description: >-
              Returns the elements in the list that come after the specified
              cursor.
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: before
          required: false
          schema:
            description: >-
              Returns the elements in the list that come before the specified
              cursor.
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: first
          required: false
          schema:
            description: Returns the first _n_ elements from the list.
            example: 42
            type:
              - integer
              - 'null'
          style: form
        - explode: true
          in: query
          name: last
          required: false
          schema:
            description: Returns the last _n_ elements from the list.
            example: 42
            type:
              - integer
              - 'null'
          style: form
        - explode: true
          in: query
          name: company_id
          required: false
          schema:
            description: The unique identifier of the company to list payments for.
            example: biz_xxxxxxxxxxxxxx
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: direction
          required: false
          schema:
            description: >-
              The sort direction for ordering results, either ascending or
              descending.
            oneOf:
              - $ref: '#/components/schemas/Direction'
              - type: 'null'
          style: form
        - explode: true
          in: query
          name: order
          required: false
          schema:
            description: The field to order results by, such as creation date.
            oneOf:
              - $ref: '#/components/schemas/ReceiptV2Order'
              - type: 'null'
          style: form
        - explode: true
          in: query
          name: product_ids
          required: false
          schema:
            description: >-
              Filter payments to only those associated with these specific
              product identifiers.
            items:
              description: >-
                Represents a unique identifier that is Base64 obfuscated. It is
                often used to refetch an object or as key for a cache. The ID
                type appears in a JSON response as a String; however, it is not
                intended to be human-readable. When expected as an input type,
                any string (such as `"VXNlci0xMA=="`) or integer (such as `4`)
                input value will be accepted as an ID.
              type: string
            type:
              - array
              - 'null'
          style: form
        - explode: true
          in: query
          name: billing_reasons
          required: false
          schema:
            description: Filter payments by their billing reason.
            items:
              $ref: '#/components/schemas/BillingReasons'
            type:
              - array
              - 'null'
          style: form
        - explode: true
          in: query
          name: currencies
          required: false
          schema:
            description: Filter payments by their currency code.
            items:
              $ref: '#/components/schemas/Currencies'
            type:
              - array
              - 'null'
          style: form
        - explode: true
          in: query
          name: plan_ids
          required: false
          schema:
            description: >-
              Filter payments to only those associated with these specific plan
              identifiers.
            items:
              description: >-
                Represents a unique identifier that is Base64 obfuscated. It is
                often used to refetch an object or as key for a cache. The ID
                type appears in a JSON response as a String; however, it is not
                intended to be human-readable. When expected as an input type,
                any string (such as `"VXNlci0xMA=="`) or integer (such as `4`)
                input value will be accepted as an ID.
              type: string
            type:
              - array
              - 'null'
          style: form
        - explode: true
          in: query
          name: statuses
          required: false
          schema:
            description: Filter payments by their current status.
            items:
              $ref: '#/components/schemas/ReceiptStatus'
            type:
              - array
              - 'null'
          style: form
        - explode: true
          in: query
          name: substatuses
          required: false
          schema:
            description: >-
              Filter payments by their current substatus for more granular
              filtering.
            items:
              $ref: '#/components/schemas/FriendlyReceiptStatus'
            type:
              - array
              - 'null'
          style: form
        - explode: true
          in: query
          name: include_free
          required: false
          schema:
            description: Whether to include payments with a zero amount.
            type:
              - boolean
              - 'null'
          style: form
        - explode: true
          in: query
          name: created_before
          required: false
          schema:
            description: Only return payments created before this timestamp.
            example: '2023-12-01T05:00:00.401Z'
            format: date-time
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: created_after
          required: false
          schema:
            description: Only return payments created after this timestamp.
            example: '2023-12-01T05:00:00.401Z'
            format: date-time
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: updated_before
          required: false
          schema:
            description: Only return payments last updated before this timestamp.
            example: '2023-12-01T05:00:00.401Z'
            format: date-time
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: updated_after
          required: false
          schema:
            description: Only return payments last updated after this timestamp.
            example: '2023-12-01T05:00:00.401Z'
            format: date-time
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: query
          required: false
          schema:
            description: >-
              Search payments by user ID, membership ID, user email, name, or
              username. Email filtering requires the member:email:read
              permission.
            type:
              - string
              - 'null'
          style: form
        - explode: true
          in: query
          name: checkout_configuration_ids
          required: false
          schema:
            description: Only return payments from these checkout configurations.
            items:
              description: >-
                Represents a unique identifier that is Base64 obfuscated. It is
                often used to refetch an object or as key for a cache. The ID
                type appears in a JSON response as a String; however, it is not
                intended to be human-readable. When expected as an input type,
                any string (such as `"VXNlci0xMA=="`) or integer (such as `4`)
                input value will be accepted as an ID.
              type: string
            type:
              - array
              - 'null'
          style: form
      responses:
        '200':
          content:
            application/json:
              schema:
                description: The connection type for Receipt.
                properties:
                  data:
                    description: A list of nodes.
                    items:
                      $ref: '#/components/schemas/PaymentListItem'
                    type: array
                  page_info:
                    $ref: '#/components/schemas/PageInfo'
                    description: Information to aid in pagination.
                required:
                  - data
                  - page_info
                type: object
          description: A successful response
        '400':
          content:
            application/json:
              example:
                error:
                  code: parameter_missing
                  message: 'Missing required parameter: amount.'
                  param: amount
                  type: invalid_request_error
              schema:
                properties:
                  error:
                    properties:
                      code:
                        description: >-
                          A short string indicating the specific error code,
                          e.g. 'parameter_missing', 'parameter_invalid',
                          'invalid_json'
                        type:
                          - string
                          - 'null'
                      message:
                        type: string
                      param:
                        description: The parameter that caused the error, if applicable
                        type:
                          - string
                          - 'null'
                      type:
                        type: string
                    required:
                      - type
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Bad request
        '401':
          content:
            application/json:
              example:
                error:
                  message: Invalid or missing API key
                  type: unauthorized
              schema:
                properties:
                  error:
                    properties:
                      code:
                        description: >-
                          A short string indicating the specific error code,
                          e.g. 'parameter_missing', 'parameter_invalid',
                          'invalid_json'
                        type:
                          - string
                          - 'null'
                      message:
                        type: string
                      param:
                        description: The parameter that caused the error, if applicable
                        type:
                          - string
                          - 'null'
                      type:
                        type: string
                    required:
                      - type
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Unauthorized
        '403':
          content:
            application/json:
              example:
                error:
                  message: You do not have permission to access this resource
                  type: forbidden
              schema:
                properties:
                  error:
                    properties:
                      code:
                        description: >-
                          A short string indicating the specific error code,
                          e.g. 'parameter_missing', 'parameter_invalid',
                          'invalid_json'
                        type:
                          - string
                          - 'null'
                      message:
                        type: string
                      param:
                        description: The parameter that caused the error, if applicable
                        type:
                          - string
                          - 'null'
                      type:
                        type: string
                    required:
                      - type
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Forbidden
        '404':
          content:
            application/json:
              example:
                error:
                  message: Resource not found
                  type: not_found
              schema:
                properties:
                  error:
                    properties:
                      code:
                        description: >-
                          A short string indicating the specific error code,
                          e.g. 'parameter_missing', 'parameter_invalid',
                          'invalid_json'
                        type:
                          - string
                          - 'null'
                      message:
                        type: string
                      param:
                        description: The parameter that caused the error, if applicable
                        type:
                          - string
                          - 'null'
                      type:
                        type: string
                    required:
                      - type
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Not found
        '422':
          content:
            application/json:
              example:
                error: null
              schema:
                properties:
                  error:
                    properties:
                      code:
                        description: >-
                          A short string indicating the specific error code,
                          e.g. 'parameter_missing', 'parameter_invalid',
                          'invalid_json'
                        type:
                          - string
                          - 'null'
                      message:
                        type: string
                      param:
                        description: The parameter that caused the error, if applicable
                        type:
                          - string
                          - 'null'
                      type:
                        type: string
                    required:
                      - type
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Verification required
        '429':
          content:
            application/json:
              example:
                error: null
              schema:
                properties:
                  error:
                    properties:
                      code:
                        description: >-
                          A short string indicating the specific error code,
                          e.g. 'parameter_missing', 'parameter_invalid',
                          'invalid_json'
                        type:
                          - string
                          - 'null'
                      message:
                        type: string
                      param:
                        description: The parameter that caused the error, if applicable
                        type:
                          - string
                          - 'null'
                      type:
                        type: string
                    required:
                      - type
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Too many requests
        '500':
          content:
            application/json:
              example:
                error:
                  message: An unexpected error occurred
                  type: internal_server_error
              schema:
                properties:
                  error:
                    properties:
                      code:
                        description: >-
                          A short string indicating the specific error code,
                          e.g. 'parameter_missing', 'parameter_invalid',
                          'invalid_json'
                        type:
                          - string
                          - 'null'
                      message:
                        type: string
                      param:
                        description: The parameter that caused the error, if applicable
                        type:
                          - string
                          - 'null'
                      type:
                        type: string
                    required:
                      - type
                      - message
                    type: object
                required:
                  - error
                type: object
          description: Internal server error
      security:
        - bearerAuth:
            - payment:basic:read
            - plan:basic:read
            - access_pass:basic:read
            - member:email:read
            - member:basic:read
            - member:phone:read
            - promo_code:basic:read
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import Whop from '@whop/sdk';

            const client = new Whop({
              apiKey: process.env['WHOP_API_KEY'], // This is the default and can be omitted
            });

            // Automatically fetches more pages as needed.
            for await (const paymentListResponse of client.payments.list()) {
              console.log(paymentListResponse.id);
            }
components:
  schemas:
    Direction:
      description: The direction of the sort.
      enum:
        - asc
        - desc
      type: string
    ReceiptV2Order:
      description: The order to sort the results by.
      enum:
        - final_amount
        - created_at
        - paid_at
      type: string
    BillingReasons:
      description: The reason why a specific payment was billed
      enum:
        - subscription_create
        - subscription_cycle
        - subscription_update
        - one_time
        - manual
        - subscription
      type: string
    Currencies:
      description: The available currencies on the platform
      enum:
        - usd
        - sgd
        - inr
        - aud
        - brl
        - cad
        - dkk
        - eur
        - nok
        - gbp
        - sek
        - chf
        - hkd
        - huf
        - jpy
        - mxn
        - myr
        - pln
        - czk
        - nzd
        - aed
        - eth
        - ape
        - cop
        - ron
        - thb
        - bgn
        - idr
        - dop
        - php
        - try
        - krw
        - twd
        - vnd
        - pkr
        - clp
        - uyu
        - ars
        - zar
        - dzd
        - tnd
        - mad
        - kes
        - kwd
        - jod
        - all
        - xcd
        - amd
        - bsd
        - bhd
        - bob
        - bam
        - khr
        - crc
        - xof
        - egp
        - etb
        - gmd
        - ghs
        - gtq
        - gyd
        - ils
        - jmd
        - mop
        - mga
        - mur
        - mdl
        - mnt
        - nad
        - ngn
        - mkd
        - omr
        - pyg
        - pen
        - qar
        - rwf
        - sar
        - rsd
        - lkr
        - tzs
        - ttd
        - uzs
        - rub
        - btc
        - cny
        - usdt
        - kzt
        - awg
        - whop_usd
        - xau
      type: string
    ReceiptStatus:
      description: The status of a receipt
      enum:
        - draft
        - open
        - paid
        - pending
        - uncollectible
        - unresolved
        - void
      type: string
    FriendlyReceiptStatus:
      description: >-
        The friendly status of a payment. This is a derived status that provides
        a human-readable summary of the payment state, combining the underlying
        status and substatus fields.
      enum:
        - succeeded
        - pending
        - failed
        - past_due
        - canceled
        - price_too_low
        - uncollectible
        - refunded
        - auto_refunded
        - partially_refunded
        - dispute_warning
        - dispute_needs_response
        - dispute_warning_needs_response
        - resolution_needs_response
        - dispute_under_review
        - dispute_warning_under_review
        - resolution_under_review
        - dispute_won
        - dispute_warning_closed
        - resolution_won
        - dispute_lost
        - dispute_closed
        - resolution_lost
        - drafted
        - incomplete
        - unresolved
        - open_dispute
        - open_resolution
      type: string
    PaymentListItem:
      description: >-
        A payment represents a completed or attempted charge. Payments track the
        amount, status, currency, and payment method used.
      properties:
        amount_after_fees:
          description: How much the payment is for after fees
          example: 6.9
          type: number
        application_fee:
          description: The application fee charged on this payment.
          properties:
            amount:
              description: The application fee amount.
              example: 6.9
              type: number
            amount_captured:
              description: The amount of the application fee that has been captured.
              example: 6.9
              type: number
            amount_refunded:
              description: The amount of the application fee that has been refunded.
              example: 6.9
              type: number
            created_at:
              description: The datetime the application fee was created.
              example: '2023-12-01T05:00:00.401Z'
              format: date-time
              type: string
            currency:
              $ref: '#/components/schemas/Currencies'
              description: The currency of the application fee.
            id:
              description: The unique identifier for the application fee.
              example: apfee_xxxxxxxxxxxx
              type: string
          required:
            - id
            - amount
            - amount_captured
            - amount_refunded
            - currency
            - created_at
          type:
            - object
            - 'null'
        auto_refunded:
          description: Whether this payment was auto refunded or not
          type: boolean
        billing_address:
          description: The address of the user who made the payment.
          properties:
            city:
              description: The city of the address.
              type:
                - string
                - 'null'
            country:
              description: The country of the address.
              type:
                - string
                - 'null'
            line1:
              description: The line 1 of the address.
              type:
                - string
                - 'null'
            line2:
              description: The line 2 of the address.
              type:
                - string
                - 'null'
            name:
              description: The name of the customer.
              type:
                - string
                - 'null'
            postal_code:
              description: The postal code of the address.
              type:
                - string
                - 'null'
            state:
              description: The state of the address.
              type:
                - string
                - 'null'
          required:
            - name
            - line1
            - line2
            - city
            - state
            - postal_code
            - country
          type:
            - object
            - 'null'
        billing_reason:
          description: >-
            The machine-readable reason this charge was created, such as initial
            subscription purchase, renewal cycle, or one-time payment.
          oneOf:
            - $ref: '#/components/schemas/BillingReasons'
            - type: 'null'
        card_brand:
          description: >-
            Card network reported by the processor (e.g., 'visa', 'mastercard',
            'amex'). Present only when the payment method type is 'card'.
          oneOf:
            - $ref: '#/components/schemas/CardBrands'
            - type: 'null'
        card_last4:
          description: >-
            The last four digits of the card used to make this payment. Null if
            the payment was not made with a card.
          example: '4242'
          type:
            - string
            - 'null'
        checkout_configuration_id:
          description: >-
            The ID of the checkout session/configuration that produced this
            payment, if any. Use this to map payments back to the checkout
            configuration that created them.
          type:
            - string
            - 'null'
        company:
          description: The company for the payment.
          properties:
            id:
              description: The unique identifier for the company.
              example: biz_xxxxxxxxxxxxxx
              type: string
            route:
              description: The slug/route of the company on the Whop site.
              type: string
            title:
              description: The written name of the company.
              type: string
          required:
            - id
            - title
            - route
          type:
            - object
            - 'null'
        created_at:
          description: The datetime the payment was created.
          example: '2023-12-01T05:00:00.401Z'
          format: date-time
          type: string
        currency:
          $ref: '#/components/schemas/Currencies'
          description: >-
            The three-letter ISO currency code for this payment (e.g., 'usd',
            'eur').
        customer_phone:
          description: >-
            Phone number the customer provided at checkout, or their verified
            phone number when your checkout requires phone verification. `null`
            when no phone number was collected.
          type:
            - string
            - 'null'
        dispute_alerted_at:
          description: When an alert came in that this transaction will be disputed
          example: '2023-12-01T05:00:00.401Z'
          format: date-time
          type:
            - string
            - 'null'
        failure_message:
          description: If the payment failed, the reason for the failure.
          type:
            - string
            - 'null'
        id:
          description: The unique identifier for the payment.
          example: pay_xxxxxxxxxxxxxx
          type: string
        last_payment_attempt:
          description: The time of the last payment attempt.
          example: '2023-12-01T05:00:00.401Z'
          format: date-time
          type:
            - string
            - 'null'
        member:
          description: The member attached to this payment.
          properties:
            id:
              description: The unique identifier for the company member.
              type: string
            phone:
              description: The phone number for the member, if available.
              type:
                - string
                - 'null'
          required:
            - id
            - phone
          type:
            - object
            - 'null'
        membership:
          description: The membership attached to this payment.
          properties:
            id:
              description: The unique identifier for the membership.
              example: mem_xxxxxxxxxxxxxx
              type: string
            phone_number:
              description: The phone number associated with this membership.
              type:
                - string
                - 'null'
            status:
              $ref: '#/components/schemas/MembershipStatus'
              description: The state of the membership.
          required:
            - id
            - status
            - phone_number
          type:
            - object
            - 'null'
        metadata:
          additionalProperties: true
          description: >-
            The custom metadata stored on this payment. This will be copied over
            to the checkout configuration for which this payment was made
          type:
            - object
            - 'null'
        next_payment_attempt:
          description: The time of the next schedule payment retry.
          example: '2023-12-01T05:00:00.401Z'
          format: date-time
          type:
            - string
            - 'null'
        paid_at:
          description: >-
            The time at which this payment was successfully collected. Null if
            the payment has not yet succeeded. As a Unix timestamp.
          example: '2023-12-01T05:00:00.401Z'
          format: date-time
          type:
            - string
            - 'null'
        payment_method:
          description: >-
            The tokenized payment method reference used for this payment. Null
            if no token was used.
          properties:
            card:
              description: >-
                The card data associated with the payment method, if its a debit
                or credit card.
              properties:
                brand:
                  description: >-
                    The card network (e.g., visa, mastercard, amex). Null if the
                    brand could not be determined.
                  oneOf:
                    - $ref: '#/components/schemas/CardBrands'
                    - type: 'null'
                exp_month:
                  description: >-
                    The two-digit expiration month of the card (1-12). Null if
                    not available.
                  example: 42
                  type:
                    - integer
                    - 'null'
                exp_year:
                  description: >-
                    The two-digit expiration year of the card (e.g., 27 for
                    2027). Null if not available.
                  example: 42
                  type:
                    - integer
                    - 'null'
                last4:
                  description: >-
                    The last four digits of the card number. Null if not
                    available.
                  example: '4242'
                  type:
                    - string
                    - 'null'
              required:
                - brand
                - last4
                - exp_month
                - exp_year
              type:
                - object
                - 'null'
            created_at:
              description: The datetime the payment token was created.
              example: '2023-12-01T05:00:00.401Z'
              format: date-time
              type: string
            id:
              description: The unique identifier for the payment token.
              example: payt_xxxxxxxxxxxxx
              type: string
            payment_method_type:
              $ref: '#/components/schemas/PaymentMethodTypes'
              description: The payment method type of the payment method
          required:
            - id
            - created_at
            - payment_method_type
            - card
          type:
            - object
            - 'null'
        payment_method_type:
          description: >-
            The type of payment instrument used for this payment (e.g., card,
            Cash App, iDEAL, Klarna, crypto). Null when the processor does not
            supply a type.
          oneOf:
            - $ref: '#/components/schemas/PaymentMethodTypes'
            - type: 'null'
        payments_failed:
          description: The number of failed payment attempts for the payment.
          example: 42
          type:
            - integer
            - 'null'
        plan:
          description: The plan attached to this payment.
          properties:
            id:
              description: The unique identifier for the plan.
              example: plan_xxxxxxxxxxxxx
              type: string
            internal_notes:
              description: A personal description or notes section for the business.
              type:
                - string
                - 'null'
            metadata:
              additionalProperties: true
              description: >-
                Custom key-value pairs stored on the plan. Included in webhook
                payloads for payment and membership events. Max 50 keys, 100
                chars per key, 500 chars per string value.
              type:
                - object
                - 'null'
          required:
            - id
            - internal_notes
            - metadata
          type:
            - object
            - 'null'
        product:
          description: The product this payment was made for
          properties:
            id:
              description: The unique identifier for the product.
              example: prod_xxxxxxxxxxxxx
              type: string
            metadata:
              additionalProperties: true
              description: >-
                Custom key-value pairs stored on the product and included in
                payment and membership webhook payloads. Max 50 keys, 100
                characters per key, 500 characters per string value.
              type:
                - object
                - 'null'
            route:
              description: >-
                URL slug in the product's public link, e.g. `pickaxe-analytics`
                in whop.com/company/pickaxe-analytics.
              example: pickaxe-analytics
              type: string
            title:
              description: >-
                The display name of the product shown to customers on the
                product page and in search results.
              example: Pickaxe Analytics
              type: string
          required:
            - id
            - title
            - route
            - metadata
          type:
            - object
            - 'null'
        promo_code:
          description: The promo code used for this payment.
          properties:
            amount_off:
              description: >-
                The discount amount. Interpretation depends on promo_type: if
                'percentage', this is the percentage (e.g., 20 means 20% off);
                if 'flat_amount', this is dollars off (e.g., 10.00 means $10.00
                off).
              example: 6.9
              type: number
            base_currency:
              $ref: '#/components/schemas/Currencies'
              description: The monetary currency of the promo code.
            code:
              description: The specific code used to apply the promo at checkout.
              type:
                - string
                - 'null'
            id:
              description: The unique identifier for the promo code.
              example: promo_xxxxxxxxxxxx
              type: string
            number_of_intervals:
              description: The number of months the promo is applied for.
              example: 42
              type:
                - integer
                - 'null'
            promo_type:
              $ref: '#/components/schemas/PromoTypes'
              description: The type (% or flat amount) of the promo.
          required:
            - id
            - code
            - amount_off
            - base_currency
            - promo_type
            - number_of_intervals
          type:
            - object
            - 'null'
        refundable:
          description: >-
            True only for payments that are `paid`, have not been fully
            refunded, and were processed by a payment processor that allows
            refunds.
          type: boolean
        refunded_amount:
          description: The payment refund amount(if applicable).
          example: 6.9
          type:
            - number
            - 'null'
        refunded_at:
          description: When the payment was refunded (if applicable).
          example: '2023-12-01T05:00:00.401Z'
          format: date-time
          type:
            - string
            - 'null'
        retryable:
          description: >-
            True when the payment status is `open` and its membership is in one
            of the retry-eligible states (`active`, `trialing`, `completed`, or
            `past_due`), or when it is a failed initial billing-engine payment
            on a `drafted` membership with an unlimited-stock plan; otherwise
            false. Used to decide if Whop can attempt the charge again.
          type: boolean
        settlement_currency:
          $ref: '#/components/schemas/Currencies'
          description: >-
            The three-letter ISO currency code for this payment (e.g., 'usd',
            'eur').
        shipping_address:
          description: >-
            The shipping address provided by the customer for physical goods.
            Null if no shipping address was collected.
          properties:
            city:
              description: The city of the address.
              type:
                - string
                - 'null'
            country:
              description: The country of the address.
              type:
                - string
                - 'null'
            line1:
              description: The line 1 of the address.
              type:
                - string
                - 'null'
            line2:
              description: The line 2 of the address.
              type:
                - string
                - 'null'
            name:
              description: The name of the customer.
              type:
                - string
                - 'null'
            postal_code:
              description: The postal code of the address.
              type:
                - string
                - 'null'
            state:
              description: The state of the address.
              type:
                - string
                - 'null'
          required:
            - name
            - line1
            - line2
            - city
            - state
            - postal_code
            - country
          type:
            - object
            - 'null'
        status:
          description: >-
            The current lifecycle state of this payment (e.g., 'draft', 'open',
            'paid', 'void').
          oneOf:
            - $ref: '#/components/schemas/ReceiptStatus'
            - type: 'null'
        substatus:
          $ref: '#/components/schemas/FriendlyReceiptStatus'
          description: The friendly status of the payment.
        subtotal:
          description: The subtotal to show to the creator (excluding buyer fees).
          example: 6.9
          type:
            - number
            - 'null'
        tax_amount:
          description: The calculated amount of the sales/VAT tax (if applicable).
          example: 6.9
          type:
            - number
            - 'null'
        tax_behavior:
          description: >-
            The type of tax inclusivity applied to the payment, for determining
            whether the tax is included in the final price, or paid on top.
          oneOf:
            - $ref: '#/components/schemas/ReceiptTaxBehaviors'
            - type: 'null'
        total:
          description: The total to show to the creator (excluding buyer fees).
          example: 6.9
          type:
            - number
            - 'null'
        updated_at:
          description: The datetime the payment was last updated.
          example: '2023-12-01T05:00:00.401Z'
          format: date-time
          type: string
        usd_total:
          description: The total in USD to show to the creator (excluding buyer fees).
          example: 6.9
          type:
            - number
            - 'null'
        user:
          description: The user that made this payment.
          properties:
            email:
              description: >-
                The user's email address. Requires the member:email:read
                permission to access. Null if not authorized.
              example: john.doe@example.com
              type:
                - string
                - 'null'
            id:
              description: The unique identifier for the user.
              example: user_xxxxxxxxxxxxx
              type: string
            name:
              description: The user's display name shown on their public profile.
              example: John Doe
              type:
                - string
                - 'null'
            username:
              description: The user's unique username shown on their public profile.
              example: johndoe42
              type: string
          required:
            - id
            - name
            - username
            - email
          type:
            - object
            - 'null'
        voidable:
          description: >-
            True when the payment is tied to a membership in `past_due`, the
            payment status is `open`, and the processor allows voiding payments;
            otherwise false.
          type: boolean
      required:
        - id
        - status
        - substatus
        - refundable
        - retryable
        - voidable
        - created_at
        - updated_at
        - paid_at
        - last_payment_attempt
        - next_payment_attempt
        - dispute_alerted_at
        - refunded_at
        - plan
        - product
        - user
        - membership
        - member
        - customer_phone
        - payment_method
        - company
        - promo_code
        - currency
        - settlement_currency
        - total
        - subtotal
        - usd_total
        - refunded_amount
        - auto_refunded
        - amount_after_fees
        - application_fee
        - card_brand
        - card_last4
        - billing_address
        - shipping_address
        - payment_method_type
        - billing_reason
        - payments_failed
        - tax_amount
        - tax_behavior
        - failure_message
        - metadata
        - checkout_configuration_id
      type: object
    PageInfo:
      description: Information about pagination in a connection.
      properties:
        end_cursor:
          description: When paginating forwards, the cursor to continue.
          type:
            - string
            - 'null'
        has_next_page:
          description: When paginating forwards, are there more items?
          type: boolean
        has_previous_page:
          description: When paginating backwards, are there more items?
          type: boolean
        start_cursor:
          description: When paginating backwards, the cursor to continue.
          type:
            - string
            - 'null'
      required:
        - end_cursor
        - start_cursor
        - has_next_page
        - has_previous_page
      type: object
    CardBrands:
      description: Possible card brands that a payment token can have
      enum:
        - mastercard
        - visa
        - amex
        - discover
        - unionpay
        - jcb
        - diners
        - link
        - troy
        - visadankort
        - visabancontact
        - china_union_pay
        - rupay
        - jcbrupay
        - elo
        - maestro
        - tarjeta_naranja
        - cirrus
        - nspk_mir
        - verve
        - ebt
        - private_label
        - local_brand
        - uatp
        - wexcard
        - uzcard
        - meeza
        - hrg_store_card
        - girocard
        - fuel_card
        - dankort
        - carnet
        - atm_card
        - china_union_payuzcard
        - codensa
        - cabal
        - hipercard
        - jcblankapay
        - cmi
        - aura
        - unknown
      type: string
    MembershipStatus:
      description: The status of a membership
      enum:
        - trialing
        - active
        - past_due
        - completed
        - canceled
        - expired
        - unresolved
        - drafted
        - canceling
      type: string
    PaymentMethodTypes:
      description: The different types of payment methods that can be used.
      enum:
        - acss_debit
        - affirm
        - afterpay_clearpay
        - alipay
        - alma
        - amazon_pay
        - apple
        - apple_pay
        - au_bank_transfer
        - au_becs_debit
        - bacs_debit
        - bancolombia
        - bancontact
        - bank_wire
        - billie
        - bizum
        - blik
        - boleto
        - bre_b
        - ca_bank_transfer
        - capchase_pay
        - card
        - card_installments_three
        - card_installments_six
        - card_installments_twelve
        - cashapp
        - claritypay
        - coinbase
        - crypto
        - custom
        - customer_balance
        - demo_pay
        - efecty
        - eps
        - eu_bank_transfer
        - fpx
        - gb_bank_transfer
        - giropay
        - google_pay
        - gopay
        - grabpay
        - id_bank_transfer
        - ideal
        - interac
        - kakao_pay
        - klarna
        - klarna_pay_now
        - konbini
        - kr_card
        - kr_market
        - kriya
        - kueski
        - link
        - mb_way
        - m_pesa
        - mercado_pago
        - mobilepay
        - mondu
        - multibanco
        - naver_pay
        - nequi
        - netbanking
        - ng_bank
        - ng_bank_transfer
        - ng_card
        - ng_market
        - ng_ussd
        - ng_wallet
        - nz_bank_account
        - oxxo
        - p24
        - pago_efectivo
        - pse
        - pay_by_bank
        - payco
        - paynow
        - paypal
        - paypay
        - payto
        - pix
        - platform_balance
        - promptpay
        - qris
        - rechnung
        - revolut_pay
        - samsung_pay
        - satispay
        - scalapay
        - sencillito
        - sepa_debit
        - sequra
        - servipag
        - sezzle
        - shop_pay
        - shopeepay
        - sofort
        - south_korea_market
        - spei
        - splitit
        - sunbit
        - swish
        - tamara
        - twint
        - upi
        - us_bank_account
        - us_bank_transfer
        - venmo
        - vipps
        - webpay
        - wechat_pay
        - yape
        - zip
        - coinflow
        - unknown
      type: string
    PromoTypes:
      description: The type of promo code used to discount a plan
      enum:
        - percentage
        - flat_amount
      type: string
    ReceiptTaxBehaviors:
      description: >-
        The type of tax inclusivity applied to the receipt, for determining
        whether the tax is included in the final price, or paid on top.
      enum:
        - exclusive
        - inclusive
        - unspecified
        - unable_to_collect
      type: string
  securitySchemes:
    bearerAuth:
      bearerFormat: auth-scheme
      description: >-
        A company API key, company scoped JWT, app API key, or user OAuth token.
        You must prepend your key/token with the word 'Bearer', which will look
        like `Bearer ***************************`
      scheme: bearer
      type: http

````