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

# Consultar as perguntas do quiz de reembolso

> Devolve as perguntas do quiz de reembolso do produto, na ordem em que o comprador as vê, ativas e inativas. O quiz tem poucas perguntas, por isso a resposta não é paginada.



## OpenAPI

````yaml /openapi.yaml get /v1/products/{productId}/refund-quiz/questions
openapi: 3.0.3
info:
  title: Ephra API
  description: >-
    API pública da Ephra: cobranças (PIX, cartão e boleto), transações, webhooks
    e a API do vendedor sobre catálogo, checkout, vendas, reembolsos,
    financeiro, crescimento e plataforma.


    **Limite de requisições.** 1000 requisições por minuto por IP de origem.
    Toda resposta traz `x-ratelimit-limit`, `x-ratelimit-remaining` e
    `x-ratelimit-reset` (segundos até a janela zerar); ao estourar o limite a
    resposta é `429` com `retry-after`.


    **Um `429` que não é limite de requisições.** Em `POST /v1/card` e `POST
    /v1/subscriptions`, um `429` com `code: "BUYER_ATTEMPTS_EXCEEDED"` no corpo
    significa que este comprador, e só ele, está bloqueado para pagar com cartão
    depois de tentativas recusadas em excesso. Nada foi cobrado. Não pause nem
    atrase as cobranças de outros compradores por causa dele, e não repita a
    cobrança deste comprador antes de `blockedUntil` (ISO 8601 UTC, também em
    `retryAfterSeconds` e no header `retry-after`; os dois campos vêm `null`
    quando o horário não é conhecido). Pix continua disponível para o mesmo
    comprador. Diferencie os dois casos sempre pelo `code`, nunca pelo status.


    **Erros.** Toda falha responde o mesmo envelope: `{ "success": false,
    "message": "..." }`.
  version: 1.0.0
servers:
  - url: https://api.ephra.io
    description: Servidor de produção
security: []
tags:
  - name: Catálogo
    description: Produtos, ofertas, categorias e cupons — o que a empresa vende.
  - name: Checkout
    description: Checkouts, order bumps, upsells e links de pagamento.
  - name: Vendas
    description: Vendas, clientes, assinaturas e entregas já realizadas.
  - name: Reembolsos
    description: Pedidos de reembolso, contestações e o quiz de retenção.
  - name: Financeiro
    description: Saldo, saques, antecipações, taxas e extratos da empresa.
  - name: Crescimento
    description: Afiliados, coprodução, indicações, pixels e integrações de marketing.
  - name: Plataforma
    description: Conta, membros, chaves de API, webhooks e configurações gerais.
paths:
  /v1/products/{productId}/refund-quiz/questions:
    get:
      tags:
        - Reembolsos
      summary: Consultar as perguntas do quiz de reembolso
      description: >-
        Devolve as perguntas do quiz de reembolso do produto, na ordem em que o
        comprador as vê, ativas e inativas. O quiz tem poucas perguntas, por
        isso a resposta não é paginada.
      operationId: getRefundQuizQuestions
      parameters:
        - schema:
            type: string
            minLength: 1
          in: path
          name: productId
          required: true
          description: Identificador do produto.
      responses:
        '200':
          description: Perguntas do quiz.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `true` em uma resposta bem-sucedida.
                  data:
                    type: object
                    properties:
                      questions:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Identificador da pergunta.
                            type:
                              type: string
                              enum:
                                - multiple_choice
                                - tags
                                - text
                              description: Múltipla escolha, tags ou texto livre.
                            title:
                              type: string
                              description: Pergunta exibida ao comprador.
                            description:
                              type: string
                              nullable: true
                              description: Texto de apoio abaixo da pergunta.
                            options:
                              type: array
                              items:
                                type: object
                                properties:
                                  value:
                                    type: string
                                    description: >-
                                      Valor gravado quando o comprador escolhe a
                                      opção.
                                  label:
                                    type: string
                                    description: Rótulo exibido ao comprador.
                                  description:
                                    type: string
                                    description: Texto de apoio da opção.
                                required:
                                  - value
                                  - label
                                additionalProperties: false
                              description: Opções da pergunta; vazio em texto livre.
                            required:
                              type: boolean
                              description: O comprador precisa responder para seguir.
                            active:
                              type: boolean
                              description: A pergunta aparece no quiz.
                            order:
                              type: integer
                              description: Posição da pergunta no quiz.
                          required:
                            - id
                            - type
                            - title
                            - description
                            - options
                            - required
                            - active
                            - order
                          additionalProperties: false
                        description: Perguntas do quiz, na ordem de exibição.
                    required:
                      - questions
                    additionalProperties: false
                required:
                  - success
                  - data
                additionalProperties: false
                description: Perguntas do quiz.
              example:
                success: true
                data:
                  questions:
                    - id: clxq1a2b30001qz0a9b8c7d6e
                      type: multiple_choice
                      title: Por que você quer o reembolso?
                      description: null
                      options:
                        - value: expectativa
                          label: Não era o que eu esperava
                        - value: tempo
                          label: Não tenho tempo para o curso
                      required: true
                      active: true
                      order: 0
        '401':
          description: Token ausente, inválido, expirado ou de empresa bloqueada.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: Token ausente, inválido, expirado ou de empresa bloqueada.
              example:
                success: false
                message: Token inválido ou expirado
        '404':
          description: O recurso não existe, foi excluído ou pertence a outra empresa.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  O recurso não existe, foi excluído ou pertence a outra
                  empresa.
              example:
                success: false
                message: Recurso não encontrado
        '422':
          description: A requisição não passou na validação de schema.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: A requisição não passou na validação de schema.
              example:
                success: false
                message: 'name: Nome é obrigatório'
        '429':
          description: >-
            Requisições demais: o limite é de 1000 requisições por minuto por IP
            de origem. Espere o número de segundos do header `retry-after` e
            repita com recuo exponencial.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Requisições demais: o limite é de 1000 requisições por minuto
                  por IP de origem. Espere o número de segundos do header
                  `retry-after` e repita com recuo exponencial.
              example:
                success: false
                message: Muitas requisições. Tente novamente em breve.
          headers:
            retry-after:
              $ref: '#/components/headers/retry-after'
            x-ratelimit-limit:
              $ref: '#/components/headers/x-ratelimit-limit'
            x-ratelimit-remaining:
              $ref: '#/components/headers/x-ratelimit-remaining'
            x-ratelimit-reset:
              $ref: '#/components/headers/x-ratelimit-reset'
        '500':
          description: >-
            Falha interna ao processar a requisição. Repita; se persistir, abra
            chamado com o horário e a rota.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: Sempre `false` em uma resposta de erro.
                  message:
                    type: string
                    description: Mensagem legível explicando a falha.
                required:
                  - success
                  - message
                additionalProperties: false
                description: >-
                  Falha interna ao processar a requisição. Repita; se persistir,
                  abra chamado com o horário e a rota.
              example:
                success: false
                message: Erro interno do servidor
      security:
        - bearerAuth: []
components:
  headers:
    retry-after:
      description: Segundos a esperar antes de repetir a requisição.
      schema:
        type: integer
    x-ratelimit-limit:
      description: Teto de requisições na janela (1000). Presente em toda resposta.
      schema:
        type: integer
    x-ratelimit-remaining:
      description: >-
        Quantas requisições ainda cabem na janela atual. Presente em toda
        resposta.
      schema:
        type: integer
    x-ratelimit-reset:
      description: Segundos até o contador da janela zerar. Presente em toda resposta.
      schema:
        type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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