> ## 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.

# Criar oferta

> Criar uma nova oferta para um produto específico

### Headers Obrigatórios

* **Authorization**: `Bearer {seu_token_aqui}`
* **Accept**: `application/json`
* **Content-Type**: `application/json`


## OpenAPI

````yaml POST /products/{hash}/offers
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:
  /products/{hash}/offers:
    post:
      description: Criar uma nova oferta para um produto específico
      parameters:
        - name: hash
          in: path
          required: true
          description: Hash ID do produto
          schema:
            type: string
      requestBody:
        description: Dados para criação da oferta
        content:
          application/json:
            schema:
              type: object
              required:
                - title
                - price
                - payment_methods
                - method_default
                - affiliates_visible
              properties:
                title:
                  type: string
                  description: Título da oferta
                price:
                  type: integer
                  description: Preço da oferta em centavos
                payment_methods:
                  type: array
                  description: >-
                    Métodos de pagamento aceitos (1 para cartão, 2 para boleto,
                    3 para pix)
                  items:
                    type: integer
                    enum:
                      - 1
                      - 2
                      - 3
                method_default:
                  type: integer
                  description: >-
                    Método de pagamento padrão (1 para cartão, 2 para boleto, 3
                    para pix)
                  enum:
                    - 1
                    - 2
                    - 3
                interval:
                  type: string
                  description: >-
                    Intervalo de recorrência (obrigatório apenas para produtos
                    de assinatura)
                  enum:
                    - daily
                    - weekly
                    - monthly
                    - quarterly
                    - semi-annual
                    - yearly
                affiliates_visible:
                  type: boolean
                  description: Se a oferta ficará visível para afiliados no marketplace
                payment_method_discounts:
                  type: array
                  description: Descontos por método de pagamento
                  items:
                    type: object
                    properties:
                      payment_method:
                        type: string
                        description: Método de pagamento para o desconto
                        enum:
                          - credit_card
                          - pix
                      discount_percentage:
                        type: number
                        description: Percentual de desconto
            examples:
              create_offer:
                summary: Exemplo de criação de oferta
                value:
                  title: Oferta Especial do Curso
                  price: 9900
                  payment_methods:
                    - 1
                    - 3
                  method_default: 1
                  interval: monthly
                  affiliates_visible: true
                  payment_method_discounts:
                    - payment_method: credit_card
                      discount_percentage: 10
        required: true
      responses:
        '201':
          description: Oferta criada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  hash:
                    type: string
                    description: Hash ID único da oferta criada
                  title:
                    type: string
                    description: Título da oferta
                  price:
                    type: integer
                    description: Preço da oferta em centavos
                  url:
                    type: string
                    description: URL do checkout dessa oferta
                  status:
                    type: integer
                    description: Status da oferta
                  interval:
                    type: string
                    nullable: true
                    description: Intervalo de recorrência da oferta
                  created_at:
                    type: string
                    description: Data de criação da oferta
                  updated_at:
                    type: string
                    description: Data de atualização da oferta
              examples:
                success:
                  summary: Exemplo de resposta de sucesso
                  value:
                    hash: abc123def
                    title: Oferta Especial do Curso
                    price: 9900
                    url: https://go.pepper.com.br/abc123def
                    status: 1
                    interval: monthly
                    created_at: '2024-12-26 15:44:26'
                    updated_at: '2024-12-26 15:44:26'
        '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: Produto não encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use o token da Pepper API no formato: `Bearer {seu_token_aqui}`'

````