> ## 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 uma transação (PIX)

> Cria uma nova transação PIX



## OpenAPI

````yaml POST /transactions
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:
    post:
      description: Cria uma nova transação PIX
      requestBody:
        description: Dados da transação PIX
        content:
          application/json:
            schema:
              type: object
              required:
                - api_token
                - amount
                - payment_method
                - cart
                - customer
              properties:
                api_token:
                  type: string
                  description: Token de autenticação da API
                amount:
                  type: integer
                  description: Valor total da transação em centavos
                payment_method:
                  type: string
                  description: Método de pagamento (pix)
                cart:
                  type: array
                  description: Itens do carrinho de compras
                  items:
                    type: object
                    properties:
                      offer_hash:
                        type: string
                        description: Hash ID da oferta
                      price:
                        type: integer
                        description: Preço do item em centavos
                      quantity:
                        type: integer
                        description: Quantidade do item
                      operation_type:
                        type: integer
                        description: >-
                          Tipo de operação (consultar sessão 'Tipos de
                          operação')
                      title:
                        type: string
                        description: Título da oferta
                      cover:
                        type: string
                        description: URL da imagem de capa
                customer:
                  type: object
                  description: Dados do cliente
                  properties:
                    name:
                      type: string
                      description: Nome do cliente
                    email:
                      type: string
                      description: Email do cliente
                    phone_number:
                      type: string
                      description: Número de telefone do cliente
                    document:
                      type: string
                      description: Documento CPF/CNPJ do cliente
                tracking:
                  type: object
                  description: Dados de rastreamento e UTM
                  properties:
                    src:
                      type: string
                      description: Fonte de origem
                    utm_source:
                      type: string
                      description: Fonte UTM
                    utm_campaign:
                      type: string
                      description: Campanha UTM
                    utm_content:
                      type: string
                      description: Conteúdo UTM
                    utm_term:
                      type: string
                      description: Termo UTM
                    utm_medium:
                      type: string
                      description: Meio UTM
            examples:
              pix_transaction:
                summary: Exemplo de criação de transação PIX
                value:
                  api_token: token_123
                  amount: 10000
                  payment_method: pix
                  cart:
                    - offer_hash: off_123
                      price: 10000
                      quantity: 1
                      operation_type: 1
                      title: oferta promocional
                      cover: https://google.com/image
                  installments: 1
                  customer:
                    name: João Silva
                    email: joao@email.com
                    phone_number: '11999999999'
                    document: '12345678901'
                  tracking:
                    src: google
                    utm_source: google
                    utm_campaign: black_friday
                    utm_content: banner_1
                    utm_term: pagamento
                    utm_medium: cpc
        required: true
      responses:
        '200':
          description: Transação criada com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      transaction_hash:
                        type: string
                      payment_url:
                        type: string
                      qr_code:
                        type: string
        '400':
          description: Erro na requisição
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Use o token da Pepper API no formato: `Bearer {seu_token_aqui}`'

````