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

# Verificar cupom

> Verifica a validade de um cupom de desconto e retorna informações sobre o desconto aplicável.



## OpenAPI

````yaml POST /transactions/coupon
openapi: 3.1.0
info:
  title: Pepper API v1
  description: Documentação da API pública da Pepper.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.cloud.pepperpay.com.br/public/v1/
security:
  - bearerAuth: []
paths:
  /transactions/coupon:
    post:
      description: >-
        Verifica a validade de um cupom de desconto e retorna informações sobre
        o desconto aplicável.
      requestBody:
        description: Dados para verificação do cupom
        content:
          application/json:
            schema:
              type: object
              required:
                - code
                - offer_hash
              properties:
                code:
                  type: string
                  description: Código do cupom a ser verificado
                  example: DESCONTO10
                offer_hash:
                  type: string
                  description: Hash da oferta para a qual o cupom será aplicado
                  example: off_123
            examples:
              request:
                summary: Exemplo de requisição
                value:
                  code: DESCONTO10
                  offer_hash: off_123
        required: true
      responses:
        '200':
          description: Cupom verificado com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  hash:
                    type: string
                    description: Hash único do cupom verificado
                  code:
                    type: string
                    description: Código do cupom verificado
                  discount_type:
                    type: string
                    description: Tipo de desconto aplicado pelo cupom
                    enum:
                      - monetary
                      - percentage
                  discount:
                    type: integer
                    description: >-
                      Valor do desconto em centavos (para tipo 'monetary') ou
                      percentual (para tipo 'percentage')
              examples:
                success:
                  summary: Cupom válido
                  value:
                    hash: 124xass
                    code: off_123
                    discount_type: monetary
                    discount: 1000
        '400':
          description: Parâmetros inválidos ou ausentes
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: string
        '404':
          description: Cupom não encontrado ou inválido
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '410':
          description: Cupom expirado
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
        '422':
          description: Cupom não aplicável à oferta especificada
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use o token da Pepper API no formato: `Bearer {seu_token_aqui}`'

````