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

> ## Agent Instructions
> Valora Payments API (Brazil: Pix, card, boleto). Base URL https://api.valorapayments.com.br, Authorization: Bearer sk_vl_... used only on the server. Request amounts are reais as strings ("149.90"); response amounts are integer cents (14990). Use POST /v1/checkouts for card and boleto; POST /v1/payments only creates Pix and should send an Idempotency-Key. Confirm payments only through the payment.succeeded webhook after verifying X-Valora-Signature (hex HMAC-SHA256 of "<t>.<raw body>"), dedupe by event.id and check livemode. Never invent endpoints or fields: check /llms.txt and /openapi.json.

# Listar endpoints de webhook

> Lista os endpoints ativos.

Escopo: `webhooks:read`.



## OpenAPI

````yaml /openapi.json get /v1/webhooks
openapi: 3.1.0
info:
  title: Valora Payments API
  version: 1.0.0
  description: >-
    API REST da Valora Payments. Valores na entrada em reais (texto, ex.:
    "149.90"); nas respostas, em centavos inteiros.
servers:
  - url: https://api.valorapayments.com.br
    description: Teste e produção (o ambiente vem da chave)
security:
  - bearerAuth: []
tags:
  - name: Pagamentos
  - name: Checkouts
  - name: Clientes
  - name: Produtos
  - name: Saldo
  - name: Webhooks
paths:
  /v1/webhooks:
    get:
      tags:
        - Webhooks
      summary: Listar endpoints de webhook
      description: |-
        Lista os endpoints ativos.

        Escopo: `webhooks:read`.
      operationId: listarWebhooks
      responses:
        '200':
          description: Endpoints.
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    description: Sempre `list`.
                    enum:
                      - list
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookEndpoint'
        '401':
          description: Chave ausente, inválida ou revogada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: invalid_api_key
                  message: Chave de API inválida ou revogada.
        '403':
          description: >-
            A chave não tem o escopo da rota, ou a empresa ainda não opera em
            produção.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: missing_scope
                  message: A chave não tem o escopo necessário.
        '429':
          description: Limite de requisições. Veja o header `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: rate_limited
                  message: Muitas requisições. Tente novamente em instantes.
        '503':
          description: Indisponibilidade temporária.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  type: service_unavailable
                  message: Serviço temporariamente indisponível.
      security:
        - bearerAuth: []
components:
  schemas:
    WebhookEndpoint:
      type: object
      properties:
        id:
          type: string
          description: Id do endpoint.
          pattern: ^we_[A-Za-z0-9_-]{16}$
          examples:
            - we_Xk2v9QeR7tLmN3bA
        object:
          type: string
          description: Sempre `webhook_endpoint`.
          enum:
            - webhook_endpoint
        url:
          type: string
          description: URL que recebe os eventos.
          format: uri
        description:
          type:
            - string
            - 'null'
          description: Descrição.
        events:
          type: array
          items:
            type: string
            enum:
              - payment.succeeded
              - payment.expired
              - payment.failed
              - payment.canceled
              - payment.refunded
              - payment.disputed
              - payment.dispute_won
              - payment.dispute_lost
              - '*'
          description: Eventos assinados. `*` = todos.
        status:
          type: string
          description: Estado.
          enum:
            - active
            - disabled
        created_at:
          type: string
          description: Criação.
          format: date-time
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - type
            - message
          properties:
            type:
              type: string
              description: Código estável do erro. Veja a página Erros.
              examples:
                - invalid_request
            message:
              type: string
              description: Explicação em português. Não compare o texto.
              examples:
                - Corpo inválido.
            details:
              type: object
              additionalProperties:
                type: array
                items:
                  type: string
              description: 'Só em erros de validação: problemas por campo.'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Chave de API `sk_vl_...` criada no painel em Desenvolvedores → Chaves de
        API.

````

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