v1

latestOpenAPI 3.0.3MIT2026-07-132418.0 KB

PIX

Criar PIX Estático

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.

post/v1/charges/pix/static

Request body

descriptionstring required

Descrição que aparece no QR Code

identifierstring

Identificador único para rastreamento

suggested_amountsinteger[]

Lista de valores sugeridos em centavos

min_amountinteger

Valor mínimo aceito em centavos

max_amountinteger

Valor máximo aceito em centavos

metadataobject

Dados adicionais em formato chave-valor

Example request

{
  "description": "Doações para ONG Esperança",
  "merchant": {
    "name": "ONG Esperança",
    "city": "São Paulo",
    "document": "12.345.678/0001-95"
  },
  "identifier": "doacoes_esperanca_2024",
  "suggested_amounts": [
    1000,
    2500,
    5000,
    10000
  ],
  "min_amount": 500,
  "max_amount": 50000,
  "metadata": {
    "categoria": "doacao",
    "campanha": "natal_2024"
  }
}

Response

PIX Estático criado com sucesso

idstring

typestring

status'active' | 'inactive'

descriptionstring

suggested_amountsinteger[]

created_atstring date-time

Example response

{
  "id": "pix_static_7h8i9j0k",
  "type": "pix_static",
  "status": "active",
  "description": "Doações para ONG Esperança",
  "pix": {
    "key": "pix_static_7h8i9j0k@debita.ai"
  },
  "suggested_amounts": [
    1000,
    2500,
    5000,
    10000
  ]
}