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

# List payments for a store



## OpenAPI

````yaml get /v1/stores/{store}/payments
openapi: 3.1.0
info:
  version: 1.0.0
  title: Confío public api
servers:
  - description: Production
    url: https://api.confiopagos.com
  - description: Development
    url: https://api.dev.confiopagos.com
security:
  - bearerAuth: []
paths:
  /v1/stores/{store}/payments:
    get:
      summary: List payments for a store
      parameters:
        - schema:
            type: string
            description: The unique identifier of the store.
            example: waxhsjr47zsl
          required: true
          description: The unique identifier of the store.
          name: store
          in: path
        - schema:
            type: string
            description: >-
              The maximum number of payments to return. Default is 50, max is
              1000.
            example: '20'
          required: false
          description: >-
            The maximum number of payments to return. Default is 50, max is
            1000.
          name: pageSize
          in: query
        - schema:
            type: string
            description: >-
              A page token received from a previous ListPayments call for
              pagination.
          required: false
          description: >-
            A page token received from a previous ListPayments call for
            pagination.
          name: pageToken
          in: query
      responses:
        '200':
          description: Successfully fetched payments.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListPaymentsResponse'
components:
  schemas:
    ListPaymentsResponse:
      type: object
      properties:
        payments:
          type: array
          items:
            $ref: '#/components/schemas/Payment'
          description: List of payments
        nextPageToken:
          type: string
          description: Token for retrieving the next page of results
      required:
        - payments
    Payment:
      type: object
      properties:
        correlationId:
          type: string
          description: >-
            Your internal payment/order ID for tracking and correlation. Use
            this to match Confío payments with your system's orders.
          example: '36285414'
        amountCents:
          type: number
          minimum: 1000000
          description: Amount in cents
          example: 5000000
        currencyCode:
          type: string
          description: Currency code
          example: COP
        mediaAssets:
          type: array
          items:
            type: string
            format: uri
          maxItems: 6
          description: >-
            Media assets links (required when paymentType is PRODUCT, max 6
            items). Each URL must be a publicly accessible URL from a public
            server (e.g., your CDN, cloud storage, or any public web server).
            **Allowed formats:** PNG, JPEG, JPEG XL, WebP, AVIF, GIF, ICO, SVG,
            HEIC, BMP, TIFF. **Maximum file size:** 100MB per file.
          example:
            - >-
              https://fastly.picsum.photos/id/1074/1024/1024.jpg?hmac=usAeJI_o3wzbLAca-PMBgHQXXhSoMNP5cvoktlhiUzY
            - >-
              https://fastly.picsum.photos/id/506/1024/1024.jpg?hmac=Wa93nuNDFEXWB_Fg4n2vcYT3sGcW7UBTjOAic46R9Gw
            - >-
              https://fastly.picsum.photos/id/343/1024/1024.jpg?hmac=WC3PsYGjbqnsQhfu1J1l3PeAzmsGEiZPISXAenRc2Qc
        title:
          type: string
          description: Payment title
          example: Juguete
        description:
          type: string
          description: Payment description (at least 24 characters)
          example: Juguete increíble
        buyer:
          type: object
          properties:
            firstName:
              type: string
              description: Buyer first name
              example: Julián
            lastName:
              type: string
              description: Buyer last name
              example: Pérez
            phoneNumber:
              type: string
              description: Buyer phone number (E.164 format)
              example: '+573215786325'
            email:
              type: string
              format: email
              description: >-
                Buyer email address (optional). Required when
                no_auth_payment_link feature is enabled for your organization.
              example: santiago@example.com
          required:
            - firstName
            - phoneNumber
        enabledPaymentMethods:
          type: array
          items:
            type: string
            enum:
              - PSE
              - CARD
              - BANCOLOMBIA
              - NEQUI
          description: >-
            Optional list of payment methods to enable for this payment. If
            omitted, all available methods are shown.
          example:
            - PSE
            - CARD
            - NEQUI
            - BANCOLOMBIA
        paymentType:
          type: string
          enum:
            - PRODUCT
            - SERVICE
          default: PRODUCT
          description: 'Payment type: ''PRODUCT'' or ''SERVICE'', default is ''PRODUCT'''
          example: PRODUCT
        redirectUri:
          type: string
          format: uri
          description: Redirect URI after payment creation
          example: https://example.com/payment-status
        courier:
          type: string
          description: Name of the courier service used for delivery (optional)
          example: Coordinadora
        trackingNumber:
          type: string
          description: Courier tracking number for delivery (optional)
          example: '453265'
        disableBuyerNotification:
          type: boolean
          default: false
          description: >-
            Disable WhatsApp notification to buyer on payment creation. By
            default, a notification is sent to the buyer's WhatsApp when a
            payment is created. Set to true to disable this notification.
          example: false
        discountPercentage:
          type: number
          minimum: 0
          maximum: 1
          description: >-
            Discount percentage applied to the payment as decimal (0-1, e.g.,
            0.35 for 35%).
          example: 0.1
        discountSource:
          type: string
          description: >-
            The source of the discount (e.g., 'ty_page_cod_conversion',
            'promo_code', 'referral')
          example: ty_page_cod_conversion
        name:
          type: string
          description: Payment's resource name
          example: >-
            stores/01JNRRDZDPH40DB2YRW329BFXM/payments/01JNRVWWHH68E76V3TMFFT6GHJ
        status:
          type: string
          enum:
            - STATUS_UNSPECIFIED
            - AWAITING_PAYMENT
            - PAYMENT_IN_PROGRESS
            - FUNDED
            - DELIVERING
            - UNDER_REVIEW
            - APPROVED
            - DISPUTED
            - REFUNDED
            - EXPIRED
            - CANCELED
            - FAILED
          description: Payment status
          example: AWAITING_PAYMENT
        organization:
          type: string
          description: Organization's resource name
          example: organizations/01JNRR1NY8MDX4XCGG0N4F06X3
        url:
          type: string
          description: Payment link
          example: https://checkout.confiopagos.com/p/01JNV8CSHNN933B09T5MTNK89V
        createTime:
          type: string
          description: Creation timestamp
          example: '2024-01-15T10:30:00Z'
        updateTime:
          type: string
          description: Last update timestamp
          example: '2024-01-15T10:30:00Z'
        expireTime:
          type: string
          description: Payment expiration timestamp
          example: '2024-01-18T10:30:00Z'
      required:
        - amountCents
        - currencyCode
        - title
        - description
        - buyer
        - name
        - status
        - organization
        - url
        - createTime
        - updateTime
        - expireTime
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````