---
title: "Criar PIX Dinâmico"
method: POST
path: "/v1/charges/pix/dynamic"
tags: ["PIX"]
---

# Criar PIX Dinâmico

`POST /v1/charges/pix/dynamic`

## Request

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

Cria uma cobrança PIX com QR Code único, valor predefinido e expiração automática. Ideal para e-commerce e pagamentos únicos.

## Request body

- object
  - `amount` integer, required: Valor em centavos (R$ 100,00 = 10000)
  - `description` string, required: Descrição da cobrança
  - `customer` Customer
    - `name` string, required: Nome completo do cliente
    - `document` string, required: CPF ou CNPJ do cliente
    - `email` string, email: E-mail do cliente
    - `phone` string: Telefone com código do país
  - `expires_at` string, date-time: Data de expiração (ISO 8601). Se não informado, expira em 30 minutos
  - `external_id` string: ID externo para controle (opcional)
  - `metadata` object: Dados adicionais em formato chave-valor

## Response `201`

PIX Dinâmico criado com sucesso

- PixDynamicResponse
  - `id` string: ID único da cobrança
  - `status` 'pending' | 'confirmed' | 'expired' | 'failed': Status atual da cobrança
  - `amount` integer: Valor em centavos
  - `currency` string
  - `description` string
  - `pix` object
    - `qr_code` string: QR Code em formato base64
    - `payload` string: String PIX para copy/paste no app bancário
    - `txid` string: Transaction ID único do PIX
    - `expires_at` string, date-time: Data/hora de expiração
  - `customer` Customer
    - `name` string, required: Nome completo do cliente
    - `document` string, required: CPF ou CNPJ do cliente
    - `email` string, email: E-mail do cliente
    - `phone` string: Telefone com código do país
  - `created_at` string, date-time

## Other responses

- `400`: Dados de entrada inválidos
- `401`: Chave API inválida ou ausente
- `422`: Dados válidos mas não processáveis

---

[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)
