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

> ## Agent Instructions
> Documentação oficial da sinnu, gateway de pagamento brasileiro: Pix e cartão de crédito. O índice de todas as páginas está em https://docs.sinnu.com.br/llms.txt.
> A API (https://api.sinnu.com.br) e o checkout (https://pay.sinnu.com.br) documentados são de produção. Não há ambiente público de testes: cada chamada cria ou altera dados reais.
> A chave secreta sk_live_ fica só no servidor. O navegador recebe apenas o slug do link ou a URL do checkout.
> Unidades: amountCents do link e os valores de /api/transactions/ estão em centavos (inteiro). data.amount do webhook e amount das transações de um link estão em reais. Compare na mesma unidade.
> Status: a API de transações usa approved; o corpo do webhook usa paid; o evento é transaction.approved.
> Libere o pedido só pelo webhook assinado (X-Sinnu-Signature, validado sobre o corpo cru com constructEvent({ payload, signature, secret })) e confirme com transactions.get. Nunca pelo evento completed do Sinnu Elements nem pelos parâmetros da URL de retorno.
> Estorno é sempre do valor total. Não invente métodos, campos ou eventos: confira na referência do SDK e da API.

# Liste as transações de um link

> Encontre os pagamentos associados a um link.

O campo `amount` desta resposta está em **reais**, diferente da API de transações. Um link pode ter várias transações.


## OpenAPI

````yaml GET /api/payment-links/{id}/transactions
openapi: 3.0.3
info:
  title: sinnu API
  version: 1.0.0
  description: >-
    API pública da sinnu para links, clientes e transações. Autentique com
    Bearer e a chave da empresa. Links usam amountCents em centavos; a API de
    transações usa centavos; webhooks e transações de um link usam reais.
    Consulte a unidade de cada recurso.
  x-source-sha256: 153c3fdb10dbb3d93407364e1d121b9565747a56c1b8db9ace49edcb2ef48d8a
servers:
  - url: https://api.sinnu.com.br
    description: Produção
security:
  - bearerAuth: []
paths:
  /api/payment-links/{id}/transactions:
    get:
      tags:
        - payment-links
      summary: Listar transações do link
      description: >-
        Lista as transações originadas por um link de pagamento da empresa
        autenticada.
      operationId: paymentLinks_transactions
      parameters:
        - in: path
          name: id
          schema:
            type: string
            format: uuid
          required: true
          example: 00000000-0000-4000-8000-000000000003
        - in: query
          name: page
          schema:
            type: integer
        - in: query
          name: pageSize
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedPaymentLinkTransaction'
          description: ''
        '403':
          description: Sua chave de API não tem permissão para consultar este recurso.
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl --fail-with-body --request GET \
              'https://api.sinnu.com.br/api/payment-links/ID_DO_RECURSO/transactions' \
              --header "Authorization: Bearer $SINNU_API_KEY"
        - lang: javascript
          label: JavaScript · servidor
          source: >-
            const apiKey = process.env.SINNU_API_KEY;

            if (!apiKey) throw new Error("Configure SINNU_API_KEY no
            servidor.");

            const response = await
            fetch("https://api.sinnu.com.br/api/payment-links/ID_DO_RECURSO/transactions",
            {
              method: "GET",
              headers: {
                Authorization: `Bearer ${apiKey}`,
              },
            });

            if (!response.ok) throw new Error(`HTTP ${response.status}: ${await
            response.text()}`);

            console.log(response.status === 204 ? null : await response.json());
components:
  schemas:
    PaginatedPaymentLinkTransaction:
      type: object
      properties:
        total:
          type: integer
        page:
          type: integer
        pageSize:
          type: integer
        data:
          type: array
          items:
            $ref: '#/components/schemas/PaymentLinkTransactionItem'
      required:
        - data
        - page
        - pageSize
        - total
      example:
        data:
          - id: 00000000-0000-4000-8000-000000000001
            amount: 99
            status: paid
            paymentMethod: pix
            installments: 1
            customer:
              id: 00000000-0000-4000-8000-000000000002
              name: Cliente de exemplo
              email: cliente@example.com
            createdAt: '2026-09-01T12:00:00.000Z'
            paidAt: '2026-09-01T12:00:00.000Z'
        total: 1
        page: 1
        pageSize: 20
    PaymentLinkTransactionItem:
      type: object
      properties:
        id:
          type: string
          format: uuid
        amount:
          type: number
          format: double
          maximum: 10000000000
          minimum: -10000000000
          exclusiveMaximum: true
          exclusiveMinimum: true
          description: >-
            Valor em reais (BRL). Ex.: 99.00 representa R$ 99,00. Esta unidade
            difere de /api/transactions/.
        status:
          type: string
        paymentMethod:
          type: string
        installments:
          type: integer
        customer:
          $ref: '#/components/schemas/PaymentLinkTransactionCustomer'
        createdAt:
          type: string
          format: date-time
        paidAt:
          type: string
          format: date-time
          nullable: true
      required:
        - amount
        - createdAt
        - customer
        - id
        - installments
        - paidAt
        - paymentMethod
        - status
      example:
        id: 00000000-0000-4000-8000-000000000001
        amount: 99
        status: paid
        paymentMethod: pix
        installments: 1
        customer:
          id: 00000000-0000-4000-8000-000000000002
          name: Cliente de exemplo
          email: cliente@example.com
        createdAt: '2026-09-01T12:00:00.000Z'
        paidAt: '2026-09-01T12:00:00.000Z'
    PaymentLinkTransactionCustomer:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        email:
          type: string
          format: email
      required:
        - email
        - id
        - name
      example:
        id: 00000000-0000-4000-8000-000000000002
        name: Cliente de exemplo
        email: cliente@example.com
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Chave secreta sk_live_ da empresa. Use somente no servidor.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.