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

# Criar PIX Dinâmico

`POST /v1/charges/pix/dynamic`

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.net/debita-ai/apis/debita-ai-api.md) · [All operations](https://skmtc.net/debita-ai/apis/debita-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debita-ai/debita-ai-api/revisions/654c7c3f751a/schema)