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

# List exact tenant payment economics (payment-operations)



## OpenAPI

````yaml /openapi.json get /v1/payment-operations/payments
openapi: 3.1.0
info:
  title: SimplePay API
  version: '2026-06-13'
  description: >-
    Contrato público para integrar SimplePay desde un backend. Incluye
    únicamente operaciones para comercios y administración protegida de
    credenciales.
servers:
  - description: Live
    url: https://api.simplepay.mx
  - description: Sandbox
    url: https://api.test.simplepay.mx
security:
  - SimplePayApiKey: []
tags:
  - name: API keys
  - name: Hosted Checkout
  - name: Payment Links
  - name: Payments
  - name: Refunds
  - name: Webhooks
  - name: Digital Catalog
  - name: Payment Policy
  - name: Reporting
  - name: Workspace
  - name: Customer Hub
  - name: Bookable Payments
  - name: Table Pay
  - name: Physical Checkout
  - name: In-person Payments
  - name: Terminal
  - name: Tap to Pay
  - name: Ticketing
  - name: Admission Control
  - name: Intelligence
externalDocs:
  description: SimplePay developer documentation
  url: https://docs.simplepay.mx
paths:
  /v1/payment-operations/payments:
    get:
      tags:
        - Payments
      summary: List exact tenant payment economics (payment-operations)
      operationId: listPaymentOperationsPayments
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 640
            pattern: ^[A-Za-z0-9_-]+$
      responses:
        '200':
          description: >-
            Tenant/environment-scoped payment financial facts with exact string
            minor units.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentOperationPaymentList'
components:
  schemas:
    PaymentOperationPaymentList:
      type: object
      additionalProperties: false
      required:
        - object
        - data
        - has_more
        - next_cursor
      properties:
        object:
          const: simplepay.v1.payment_list
        data:
          type: array
          maxItems: 100
          items:
            $ref: '#/components/schemas/PaymentOperationPayment'
        has_more:
          type: boolean
        next_cursor:
          type:
            - string
            - 'null'
          maxLength: 640
          pattern: ^[A-Za-z0-9_-]+$
    PaymentOperationPayment:
      type: object
      additionalProperties: false
      required:
        - object
        - id
        - currency
        - base_amount_minor
        - payer_financing_amount_minor
        - gross_amount_minor
        - simplepay_fee_amount_minor
        - merchant_net_amount_minor
        - fee_reconciliation
        - payment_method_type
        - payment_rail
        - installment_months
        - surface
        - source_ref
        - status
        - created_at
        - updated_at
      properties:
        object:
          const: simplepay.v1.payment
        id:
          type: string
          pattern: ^spatt_[a-z0-9]{32}$
        currency:
          type: string
          pattern: ^[a-z]{3}$
        base_amount_minor:
          type: string
          maxLength: 19
          pattern: ^[1-9][0-9]{0,18}$
        payer_financing_amount_minor:
          type: string
          maxLength: 19
          pattern: ^(0|[1-9][0-9]{0,18})$
        gross_amount_minor:
          type: string
          maxLength: 19
          pattern: ^[1-9][0-9]{0,18}$
        simplepay_fee_amount_minor:
          type: string
          maxLength: 19
          pattern: ^(0|[1-9][0-9]{0,18})$
        merchant_net_amount_minor:
          type: string
          maxLength: 19
          pattern: ^(0|[1-9][0-9]{0,18})$
        fee_reconciliation:
          $ref: '#/components/schemas/PaymentOperationFeeReconciliation'
        payment_method_type:
          type: string
          enum:
            - card
            - oxxo
            - spei
        payment_rail:
          type: string
          enum:
            - card_not_present
            - card_present
            - oxxo
            - spei
        installment_months:
          type:
            - integer
            - 'null'
          enum:
            - 3
            - 6
            - 9
            - 12
            - 18
            - 24
            - null
        surface:
          type: string
          enum:
            - hosted_checkout
            - payment_links
            - tap_to_pay
            - terminal
        source_ref:
          type:
            - string
            - 'null'
          maxLength: 160
          pattern: ^sp[a-z0-9]*_[A-Za-z0-9_-]{3,150}$
        status:
          type: string
          enum:
            - canceled
            - failed
            - pending
            - processing
            - reconciliation_required
            - requires_action
            - requires_payment_method
            - succeeded
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    PaymentOperationFeeReconciliation:
      type: object
      additionalProperties: false
      description: >-
        Comparison of the immutable SimplePay fee with the latest scoped
        financial fact. pending means conclusive evidence is not present;
        absence is never inferred as a match.
      required:
        - currency
        - expected_amount_minor
        - observed_amount_minor
        - observed_at
        - observed_currency
        - status
      properties:
        currency:
          type: string
          pattern: ^[a-z]{3}$
        expected_amount_minor:
          type: string
          maxLength: 19
          pattern: ^(0|[1-9][0-9]{0,18})$
        observed_amount_minor:
          type:
            - string
            - 'null'
          maxLength: 19
          pattern: ^(0|[1-9][0-9]{0,18})$
        observed_at:
          type:
            - string
            - 'null'
          format: date-time
        observed_currency:
          type:
            - string
            - 'null'
          pattern: ^[a-z]{3}$
        status:
          type: string
          description: >-
            matched only when amount and currency agree exactly; mismatch means
            observed evidence diverges; pending means no conclusive evidence
            yet.
          enum:
            - matched
            - mismatch
            - pending
      oneOf:
        - properties:
            status:
              const: pending
            observed_amount_minor:
              type: 'null'
            observed_at:
              type: 'null'
            observed_currency:
              type: 'null'
        - properties:
            status:
              enum:
                - matched
                - mismatch
            observed_amount_minor:
              type: string
              maxLength: 19
              pattern: ^(0|[1-9][0-9]{0,18})$
            observed_at:
              type: string
              format: date-time
            observed_currency:
              type: string
              pattern: ^[a-z]{3}$
  securitySchemes:
    SimplePayApiKey:
      type: http
      scheme: bearer

````