---
title: "Criar PIX Estático"
method: POST
path: "/v1/charges/pix/static"
tags: ["PIX"]
---

# Criar PIX Estático

`POST /v1/charges/pix/static`

## Request

- Base URL: `https://api.debita.ai`
- URL: `https://api.debita.ai/v1/charges/pix/static`
- Auth: HTTP bearer

Cria um QR Code PIX reutilizável onde o cliente informa o valor. Ideal para vendas físicas, doações e situações onde o valor não é conhecido antecipadamente.

## Request body

- object
  - `description` string, required: Descrição que aparece no QR Code
  - `merchant` object: Dados do estabelecimento (opcional)
    - `name` string: Nome do estabelecimento
    - `city` string: Cidade do estabelecimento
    - `document` string: CNPJ do estabelecimento
  - `identifier` string: Identificador único para rastreamento
  - `suggested_amounts` integer[]: Lista de valores sugeridos em centavos
  - `min_amount` integer: Valor mínimo aceito em centavos
  - `max_amount` integer: Valor máximo aceito em centavos
  - `metadata` object: Dados adicionais em formato chave-valor

## Response `201`

PIX Estático criado com sucesso

- PixStaticResponse
  - `id` string
  - `type` string
  - `status` 'active' | 'inactive'
  - `description` string
  - `pix` object
    - `qr_code` string: QR Code reutilizável em base64
    - `payload` string: String PIX para apps bancários
    - `key` string: Chave PIX única gerada
  - `suggested_amounts` integer[]
  - `created_at` string, date-time

## Other responses

- `400`: Dados de entrada inválidos
- `401`: Chave API inválida ou ausente

---

[API](https://skmtc.dev/debita-ai/apis/debita-ai-api.md) - [All operations](https://skmtc.dev/debita-ai/apis/debita-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/debita-ai/apis/debita-ai-api/revisions/654c7c3f751a?raw)
