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

# List payments

> Returns developer payments for the current shop. This endpoint lists payment records you already created through the Developer API; it does not return the shop's currently enabled payment methods. Use `/dev/v1/me/capabilities` when you need the payment methods enabled for the current shop. Session-backed gateways can include `checkout_url` and `session_id` when Shoppex owns the provider session.



## OpenAPI

````yaml /openapi.json get /dev/v1/payments
openapi: 3.0.3
info:
  title: Shoppex Developer API
  description: Mintlify-compatible Developer API reference for Shoppex.
  version: 1.0.0
  contact:
    name: Shoppex Support
    email: support@shoppex.io
    url: https://shoppex.io
servers:
  - url: https://api.shoppex.io
security:
  - bearerAuth: []
paths:
  /dev/v1/payments:
    get:
      tags:
        - Payments
      summary: List payments
      description: >-
        Returns developer payments for the current shop. This endpoint lists
        payment records you already created through the Developer API; it does
        not return the shop's currently enabled payment methods. Use
        `/dev/v1/me/capabilities` when you need the payment methods enabled for
        the current shop. Session-backed gateways can include `checkout_url` and
        `session_id` when Shoppex owns the provider session.
      operationId: getDevV1Payments
      parameters:
        - name: cursor
          in: query
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: string
        - name: status
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      additionalProperties: true
                  pagination:
                    type: object
                    properties:
                      next_cursor:
                        type: string
                        nullable: true
                      has_more:
                        type: boolean
                example:
                  data:
                    - id: inv_db_1
                      uniqid: 33333333-3333-4333-8333-333333333333
                      type: PAYMENT
                      shop_id: shop_1
                      customer_id: cus_1
                      currency: USD
                      gateway: PANDABASE
                      flow_type: PROVIDER_SESSION
                      provider_reference: pb_session_3
                      provider_reference_type: SESSION
                      blockchain: null
                      apm_method: CARD
                      crypto_address: null
                      crypto_amount: 0
                      crypto_received: 0
                      crypto_uri: null
                      crypto_confirmations_needed: 0
                      crypto_payment_txid: null
                      product_id: null
                      product_title: Pandabase Payment
                      product_type: CUSTOM
                      variant_title: null
                      quantity: 1
                      total: 24.99
                      total_display: 24.99
                      balance_paid_amount: 0
                      exchange_rate: 1
                      crypto_exchange_rate: 0
                      customer_email: buyer@example.com
                      custom_fields: null
                      is_developer_invoice: true
                      developer_title: Pandabase Payment
                      developer_webhook: https://app.example.com/webhooks/payments
                      developer_return_url: https://app.example.com/payments/success
                      developer_cancel_url: https://app.example.com/payments/cancelled
                      status: PENDING
                      gateways:
                        - STRIPE
                        - PANDABASE
                      checkout_url: >-
                        https://secure.pandabase.io/pay/stores/store_1/sids/pb_session_3
                      session_id: pb_session_3
                      items:
                        - product_id: null
                          product_title: Pandabase Payment
                          product_type: CUSTOM
                          variant_title: null
                          quantity: 1
                          unit_price: 24.99
                          total: 24.99
                      created_at: 1711510800
                      updated_at: 1711510860
                  pagination:
                    next_cursor: null
                    has_more: false
      deprecated: false
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Use your Shoppex API key in the Authorization header.

````