+
+
+```
+
+---
+
+## Consejos Generales
+
+- **Colores**: mantené alto contraste entre `primaryColor` ha `backgroundColor`. Evitá amarillo sobre blanco o gris claro sobre blanco.
+- **Tamaño mínimo impreso**: usá `size` ≥ 400 para impresiones. Para uso digital, 300 es suficiente.
+- **Caché**: solicitudes idénticas devuelven `fromCache: true` sin consumir crédito adicional.
+- **Rate limit**: los headers `X-RateLimit-Remaining` ha `X-Quota-Remaining` en la respuesta indican tu saldo actual.
diff --git a/Content/DevTutoriais/gerando-qrcodes-pela-api.pt-BR.md b/Content/DevTutoriais/gerando-qrcodes-pela-api.pt-BR.md
new file mode 100644
index 0000000..86c765b
--- /dev/null
+++ b/Content/DevTutoriais/gerando-qrcodes-pela-api.pt-BR.md
@@ -0,0 +1,186 @@
+---
+title: "Como Gerar QR Codes pela API: Todos os Tipos Suportados"
+description: "Guia completo para gerar QR codes via API REST usando cada tipo disponível: URL, Pix, Wi-Fi, vCard, WhatsApp, SMS, e-mail e texto livre."
+keywords: "api qr code, gerar qr code api, qr code rest api, qrrapido api, tipos qr code"
+author: "QRRapido"
+date: 2026-03-08
+lastmod: 2026-03-08
+image: ""
+---
+
+# Como Gerar QR Codes pela API: Todos os Tipos Suportados
+
+A API QRRapido suporta 8 tipos de QR code. Todos usam o mesmo endpoint — o que muda é o campo `type` e os campos específicos que compõem o `content`.
+
+## Endpoint
+
+```
+POST /api/v1/QRManager/generate
+X-API-Key: sua_chave_aqui
+Content-Type: application/json
+```
+
+## Estrutura Base da Requisição
+
+```json
+{
+ "content": "...",
+ "type": "url",
+ "size": 400,
+ "primaryColor": "#000000",
+ "backgroundColor": "#FFFFFF",
+ "outputFormat": "png"
+}
+```
+
+| Campo | Tipo | Padrão | Descrição |
+|---|---|---|---|
+| `content` | string | obrigatório | Conteúdo do QR code |
+| `type` | string | `"url"` | Tipo do QR code (ver abaixo) |
+| `size` | int | `300` | Tamanho em pixels (100–2000) |
+| `primaryColor` | string | `"#000000"` | Cor dos módulos (hex) |
+| `backgroundColor` | string | `"#FFFFFF"` | Cor de fundo (hex) |
+| `outputFormat` | string | `"png"` | Formato: `png`, `webp`, `svg` |
+
+---
+
+## Tipo `url` — Link / URL
+
+O mais simples: qualquer URL válida.
+
+```json
+{
+ "type": "url",
+ "content": "https://seusite.com.br/produto/123"
+}
+```
+
+> Use `https://` sempre que possível. QR codes com HTTP podem ser bloqueados por alguns leitores modernos.
+
+---
+
+## Tipo `pix` — Pagamento Pix
+
+O `content` deve ser a **chave Pix** do recebedor. A geração produz um QR de Pix estático (sem conexão com o Banco Central — veja o tutorial dedicado sobre Pix).
+
+```json
+{
+ "type": "pix",
+ "content": "contato@suaempresa.com.br"
+}
+```
+
+Chaves aceitas: CPF/CNPJ (apenas dígitos), e-mail, telefone no formato `+5511999999999`, ou chave aleatória (UUID).
+
+---
+
+## Tipo `wifi` — Rede Wi-Fi
+
+O `content` usa o formato padrão `WIFI:`:
+
+```json
+{
+ "type": "wifi",
+ "content": "WIFI:S:NomeDaRede;T:WPA;P:SenhaDaRede;;"
+}
+```
+
+| Parâmetro | Significado | Valores |
+|---|---|---|
+| `S:` | SSID (nome da rede) | texto |
+| `T:` | Tipo de segurança | `WPA`, `WEP`, `nopass` |
+| `P:` | Senha | texto |
+| `H:` | Rede oculta (opcional) | `true` / `false` |
+
+---
+
+## Tipo `vcard` — Cartão de Visita
+
+O `content` deve ser um vCard v3 completo:
+
+```json
+{
+ "type": "vcard",
+ "content": "BEGIN:VCARD\nVERSION:3.0\nFN:João Silva\nORG:Empresa Ltda\nTEL:+5511999999999\nEMAIL:joao@empresa.com\nURL:https://empresa.com\nEND:VCARD"
+}
+```
+
+---
+
+## Tipo `whatsapp` — Link para WhatsApp
+
+```json
+{
+ "type": "whatsapp",
+ "content": "https://wa.me/5511999999999?text=Olá%2C%20gostaria%20de%20saber%20mais"
+}
+```
+
+O número deve incluir código do país e DDD, sem espaços ou símbolos. O parâmetro `text` é opcional.
+
+---
+
+## Tipo `email` — E-mail com assunto e corpo
+
+```json
+{
+ "type": "email",
+ "content": "mailto:contato@empresa.com?subject=Assunto&body=Mensagem%20inicial"
+}
+```
+
+---
+
+## Tipo `sms` — SMS pré-preenchido
+
+```json
+{
+ "type": "sms",
+ "content": "sms:+5511999999999?body=Olá%2C%20quero%20mais%20informações"
+}
+```
+
+---
+
+## Tipo `texto` — Texto Livre
+
+Qualquer string de até 2048 caracteres:
+
+```json
+{
+ "type": "texto",
+ "content": "Mesa 12 — Atendimento preferencial disponível no balcão central."
+}
+```
+
+---
+
+## Resposta de Sucesso
+
+```json
+{
+ "success": true,
+ "qrCodeBase64": "iVBORw0KGgo...",
+ "qrId": "abc123",
+ "generationTimeMs": 180,
+ "remainingCredits": 42,
+ "fromCache": false,
+ "format": "png",
+ "mimeType": "image/png"
+}
+```
+
+Para exibir a imagem diretamente no HTML:
+
+```html
+
+```
+
+---
+
+## Dicas Gerais
+
+- **Cores**: mantenha alto contraste entre `primaryColor` e `backgroundColor`. Evite amarelo sobre branco ou cinza claro sobre branco.
+- **Tamanho mínimo impresso**: use `size` ≥ 400 para impressões. Para uso digital (telas), 300 é suficiente.
+- **Cache**: requisições idênticas retornam `fromCache: true` sem consumir crédito adicional.
+- **Rate limit**: os headers `X-RateLimit-Remaining` e `X-Quota-Remaining` na resposta indicam seu saldo atual.
diff --git a/Content/DevTutoriais/qr-code-pix-estatico.es-PY.md b/Content/DevTutoriais/qr-code-pix-estatico.es-PY.md
new file mode 100644
index 0000000..90da9b9
--- /dev/null
+++ b/Content/DevTutoriais/qr-code-pix-estatico.es-PY.md
@@ -0,0 +1,142 @@
+---
+title: "Código QR Pix Estático: Cómo Funciona y Responsabilidades del Desarrollador"
+description: "Entendé qué es el QR Pix estático, cómo lo genera la API, sus limitaciones ha por qué la verificación del pago es responsabilidad de tu aplicación — no de QRRapido."
+keywords: "qr code pix, pix estatico, qr code pix api, integración pix qr code paraguay, pix sin bacen"
+author: "QRRapido"
+date: 2026-03-08
+lastmod: 2026-03-08
+image: ""
+---
+
+# Código QR Pix Estático: Cómo Funciona y Responsabilidades del Desarrollador
+
+## ¿Qué es un Código QR Pix Estático?
+
+El Pix tiene dos tipos de QR: **estático** ha **dinámico**.
+
+| | Pix Estático | Pix Dinámico |
+|---|---|---|
+| Valor | Variable (lo decide el pagador) | Fijo (definido por el receptor) |
+| Generación | Cualquier sistema | Intermediario PSP/BACEN |
+| Registro en BACEN | **No** | Sí |
+| Notificación de pago | **No** | Sí (webhook) |
+| Uso típico | Donaciones, cobros simples | E-commerce, cobro con control |
+
+La API QRRapido genera **exclusivamente QR Pix estático**. Eso es intencional ha suficiente para la mayoría de los casos de uso.
+
+---
+
+## Cómo la API Genera el QR Pix
+
+Al enviar una solicitud con `type: "pix"`, la API arma un string en el estándar **EMV® QR Code** (estándar internacional adoptado por el Banco Central de Brasil) ha genera la imagen:
+
+```json
+{
+ "type": "pix",
+ "content": "contacto@tuempresa.com.br"
+}
+```
+
+El campo `content` debe contener **solo la clave Pix** del receptor. La API se encarga de armar el payload EMV correctamente.
+
+**Claves aceptadas:**
+- E-mail: `contacto@empresa.com.br`
+- CPF/CNPJ: solo dígitos — `12345678901` o `12345678000195`
+- Teléfono: `+5511999999999`
+- Clave aleatoria (EVP): `123e4567-e89b-12d3-a456-426614174000`
+
+---
+
+## Lo que la API NO hace (ha por qué eso importa)
+
+> **QRRapido no tiene integración con el Banco Central, con ningún banco ni PSP (Proveedor de Servicio de Pago).**
+
+Eso significa:
+
+1. **La API no sabe si el pago fue realizado.** Solo genera la imagen del QR. Lo que pasa después — si el cliente escaneó, si el Pix fue enviado, si llegó a la cuenta correcta — está fuera del alcance de la API.
+
+2. **No hay webhook de confirmación de pago.** La API no envía notificaciones cuando se recibe un Pix.
+
+3. **El QR no expira automáticamente.** Un QR Pix estático es válido indefinidamente (o hasta que la clave Pix sea eliminada por el receptor en su banco).
+
+4. **No hay rastreabilidad de transacción.** Dos solicitudes con la misma clave generan el mismo QR (con caché). No es posible asociar un escaneo a una transacción específica vía API.
+
+---
+
+## Responsabilidad de Tu Aplicación
+
+Si usás la API para generar QR Pix en un flujo de pago, **es responsabilidad de tu aplicación verificar el cobro**. Las formas correctas de hacerlo son:
+
+### Opción 1 — API Pix del Banco del Receptor
+Conectate directamente a la API Pix del banco donde está registrada la clave. La mayoría de los bancos ofrece:
+- Consulta de cobros recibidos
+- Webhook de notificación en tiempo real (cuando el banco lo soporta)
+
+### Opción 2 — PSP / Gateway de Pago
+Usá un intermediario como Mercado Pago, PagSeguro, Efí Bank, Asaas, etc. Ofrecen Pix dinámico con control completo: valor fijo, expiración, webhooks e identificación única por cobro.
+
+### Opción 3 — Verificación Manual
+Para volúmenes bajos o contextos informales (donaciones, ventas presenciales), el responsable del cobro verifica el extracto bancario manualmente.
+
+---
+
+## Flujo Recomendado (con confirmación)
+
+```
+Tu App API QRRapido Banco del Receptor
+ | | |
+ |-- POST /generate (pix) -->| |
+ |<-- qrCodeBase64 ----------| |
+ | | |
+ |-- Muestra QR al cliente | |
+ | | |
+ |-- Consulta pago ---------------------------------->|
+ |<-- Estado recibido o no ----------------------------|
+ | | |
+ |-- Libera producto/servicio| |
+```
+
+---
+
+## Ejemplo de Solicitud Completa
+
+```bash
+curl -X POST https://qrrapido.site/api/v1/QRManager/generate \
+ -H "X-API-Key: tu_clave_aqui" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "content": "contacto@tuempresa.com.br",
+ "type": "pix",
+ "size": 400,
+ "outputFormat": "webp"
+ }'
+```
+
+---
+
+## Casos de Uso Adecuados para Pix Estático vía API
+
+- QR de donación en sitio institucional
+- Menú digital con clave para pago presencial
+- Generación de QR en lote para materiales impresos (flyers, tarjetas)
+- Aplicaciones donde el vendedor ha comprador interactúan presencialmente ha el vendedor confirma el cobro en la app del banco
+
+## Casos de Uso que Requieren Pix Dinámico (no cubiertos por esta API)
+
+- E-commerce con confirmación automática del pedido
+- Cobro con valor fijo ha expiración
+- Emisión de factura vinculada al pago
+- Conciliación financiera automatizada
+
+---
+
+## Resumen
+
+| Lo que la API hace | Lo que la API NO hace |
+|---|---|
+| Genera la imagen del QR Pix | Verifica si el pago fue hecho |
+| Formatea el payload EMV correctamente | Envía webhook de confirmación |
+| Entrega PNG, WebP o SVG | Se comunica con el BACEN o bancos |
+| Funciona con cualquier clave Pix válida | Garantiza que la clave pertenece a quien dice |
+
+La generación correcta del QR es responsabilidad de la API. La **confirmación del pago es responsabilidad de tu aplicación** — ha eso, ñande lo tenemos claro ko'aga.
diff --git a/Content/DevTutoriais/qr-code-pix-estatico.pt-BR.md b/Content/DevTutoriais/qr-code-pix-estatico.pt-BR.md
new file mode 100644
index 0000000..2c608ce
--- /dev/null
+++ b/Content/DevTutoriais/qr-code-pix-estatico.pt-BR.md
@@ -0,0 +1,142 @@
+---
+title: "QR Code Pix Estático: Como Funciona e Responsabilidades do Desenvolvedor"
+description: "Entenda o que é o QR Code Pix estático, como ele é gerado pela API, suas limitações e por que a verificação do pagamento é responsabilidade da sua aplicação — não da QRRapido."
+keywords: "qr code pix, pix estatico, qr code pix api, integração pix qr code, pix sem bacen"
+author: "QRRapido"
+date: 2026-03-08
+lastmod: 2026-03-08
+image: ""
+---
+
+# QR Code Pix Estático: Como Funciona e Responsabilidades do Desenvolvedor
+
+## O que é um QR Code Pix Estático?
+
+O Pix tem dois tipos de QR code: **estático** e **dinâmico**.
+
+| | Pix Estático | Pix Dinâmico |
+|---|---|---|
+| Valor | Variável (pagador decide) | Fixo (definido pelo recebedor) |
+| Geração | Qualquer sistema | Intermediário PSP/BACEN |
+| Registro no BACEN | **Não** | Sim |
+| Notificação de pagamento | **Não** | Sim (webhook) |
+| Uso típico | Doações, cobranças simples | E-commerce, cobrança com controle |
+
+A API QRRapido gera **exclusivamente QR code Pix estático**. Isso é deliberado e suficiente para a maioria dos casos de uso.
+
+---
+
+## Como a API Gera o QR Code Pix
+
+Ao enviar uma requisição com `type: "pix"`, a API monta uma string no padrão **EMV® QR Code** (padrão internacional adotado pelo Banco Central do Brasil) e gera a imagem:
+
+```json
+{
+ "type": "pix",
+ "content": "contato@suaempresa.com.br"
+}
+```
+
+O campo `content` deve conter **apenas a chave Pix** do recebedor. A API cuida de montar o payload EMV corretamente.
+
+**Chaves aceitas:**
+- E-mail: `contato@empresa.com.br`
+- CPF/CNPJ: apenas dígitos — `12345678901` ou `12345678000195`
+- Telefone: `+5511999999999`
+- Chave aleatória (EVP): `123e4567-e89b-12d3-a456-426614174000`
+
+---
+
+## O que a API NÃO faz (e por quê isso importa)
+
+> **A QRRapido não tem integração com o Banco Central, com nenhum banco ou PSP (Provedor de Serviço de Pagamento).**
+
+Isso significa:
+
+1. **A API não sabe se o pagamento foi realizado.** Ela apenas gera a imagem do QR code. O que acontece depois — se o cliente escaneou, se o Pix foi enviado, se caiu na conta certa — está fora do escopo da API.
+
+2. **Não há webhook de confirmação de pagamento.** A API não envia notificações quando um Pix é recebido.
+
+3. **O QR code não expira automaticamente.** Um QR code Pix estático é válido indefinidamente (ou até a chave Pix ser removida pelo recebedor no banco).
+
+4. **Não há rastreabilidade de transação.** Duas requisições com a mesma chave geram o mesmo QR code (com cache). Não é possível associar um escaneamento a uma transação específica via API.
+
+---
+
+## Responsabilidade da Sua Aplicação
+
+Se você usa a API para gerar QR codes Pix em um fluxo de pagamento, **é responsabilidade da sua aplicação verificar o recebimento**. As formas corretas de fazer isso são:
+
+### Opção 1 — API Pix do Banco do Recebedor
+Conecte-se diretamente à API Pix do banco onde está registrada a chave. A maioria dos bancos oferece:
+- Consulta de cobranças recebidas
+- Webhook de notificação em tempo real (quando o banco suporta)
+
+### Opção 2 — PSP / Gateway de Pagamento
+Use um intermediário como Mercado Pago, PagSeguro, Efí Bank, Asaas, etc. Eles oferecem Pix dinâmico com controle completo: valor fixo, expiração, webhooks e identificação única por cobrança.
+
+### Opção 3 — Conferência Manual
+Para volumes baixos ou contextos informais (doações, vendas presenciais), o responsável pelo recebimento verifica o extrato bancário manualmente.
+
+---
+
+## Fluxo Recomendado (com confirmação)
+
+```
+Sua App API QRRapido Banco do Recebedor
+ | | |
+ |-- POST /generate (pix) -->| |
+ |<-- qrCodeBase64 ----------| |
+ | | |
+ |-- Exibe QR para cliente | |
+ | | |
+ |-- Consulta pagamento ------------------------------>|
+ |<-- Status recebido ou não --------------------------|
+ | | |
+ |-- Libera produto/serviço | |
+```
+
+---
+
+## Exemplo de Requisição Completa
+
+```bash
+curl -X POST https://qrrapido.site/api/v1/QRManager/generate \
+ -H "X-API-Key: sua_chave_aqui" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "content": "contato@suaempresa.com.br",
+ "type": "pix",
+ "size": 400,
+ "outputFormat": "webp"
+ }'
+```
+
+---
+
+## Casos de Uso Adequados para Pix Estático via API
+
+- QR code de doação em site institucional
+- Cardápio digital com chave para pagamento presencial
+- Geração de QR em lote para materiais impressos (flyers, cartões)
+- Aplicativos onde o vendedor e comprador interagem pessoalmente e o vendedor confirma o recebimento no app do banco
+
+## Casos de Uso que Requerem Pix Dinâmico (não atendidos por esta API)
+
+- E-commerce com confirmação automática do pedido
+- Cobrança com valor fixo e expiração
+- Emissão de nota fiscal vinculada ao pagamento
+- Conciliação financeira automatizada
+
+---
+
+## Resumo
+
+| O que a API faz | O que a API NÃO faz |
+|---|---|
+| Gera a imagem do QR code Pix | Verifica se o pagamento foi feito |
+| Formata o payload EMV corretamente | Envia webhook de confirmação |
+| Entrega PNG, WebP ou SVG | Se comunica com o BACEN ou bancos |
+| Funciona com qualquer chave Pix válida | Garante que a chave pertence a quem diz pertencer |
+
+A geração correta do QR code é responsabilidade da API. A **confirmação do pagamento é responsabilidade da sua aplicação**.
diff --git a/Controllers/DevTutoriaisController.cs b/Controllers/DevTutoriaisController.cs
new file mode 100644
index 0000000..23d7592
--- /dev/null
+++ b/Controllers/DevTutoriaisController.cs
@@ -0,0 +1,63 @@
+using Microsoft.AspNetCore.Mvc;
+using QRRapidoApp.Services;
+
+namespace QRRapidoApp.Controllers
+{
+ public class DevTutoriaisController : Controller
+ {
+ private readonly IMarkdownService _markdownService;
+ private readonly ILogger+ @Model.Metadata.ReadingTimeMinutes @T("min de leitura", "min de lectura") + · + @Model.Metadata.Date.ToString("dd/MM/yyyy") +
+@Model.Metadata.Description
+@T("Guias técnicos para integrar e usar a API QRRapido.", "Guías técnicas para integrar ha usar la API QRRapido.")
+@article.Description
+@T("Nenhum artigo encontrado.", "Ningún artículo encontrado.")
++ @T("Gerencie suas chaves de API e integre o QR Rapido nas suas aplicações.", + "Gestioná tus claves de API ha integrá QR Rapido en tus aplicaciones.") + @{ + var tier = Model.ApiSubscription?.EffectiveTier ?? QRRapidoApp.Models.ApiPlanTier.Free; + var tierLabel = tier == QRRapidoApp.Models.ApiPlanTier.Free + ? "Free" + : $"{tier}"; + } + @T("Plano atual:", "Plan actual:") @Html.Raw(tierLabel) +
++ @T("Copie agora.", "Copiá ko'aga.") + @T("Esta chave", "Esta clave") @T("não será exibida novamente", "no se mostrará de nuevo") @T("por segurança.", "por seguridad.") +
+| @T("Nome", "Nombre") | +@T("Prefixo", "Prefijo") | +@T("Criada", "Creada") | +@T("Último uso", "Último uso") | ++ |
|---|---|---|---|---|
| @key.Name | +@key.Prefix... |
+ @key.CreatedAt.ToString("dd/MM/yyyy") | ++ @(key.LastUsedAt.HasValue + ? key.LastUsedAt.Value.ToString("dd/MM/yyyy HH:mm") + : T("Nunca", "Nunca")) + | ++ + | +
@T("Nenhuma chave ativa. Crie a primeira abaixo.", "Ninguna clave activa. Creá la primera abajo.")
+@key.Prefix... |
+ @T("Revogada", "Revocada") | +
+ @T("Envie suas requisições para o endpoint abaixo com o header",
+ "Enviá tus solicitudes al endpoint de abajo con el header") X-API-Key:
+
POST @baseUrl/api/v1/QRManager/generate
+ curl -X POST \
+ @baseUrl/api/v1/QRManager/generate \
+ -H "X-API-Key: @T("SUA_CHAVE_AQUI", "TU_CLAVE_AQUI")" \
+ -H "Content-Type: application/json" \
+ -d '{
+ "content": "https://seusite.com",
+ "type": "url",
+ "size": 400,
+ "primaryColor": "#000000",
+ "backgroundColor": "#FFFFFF"
+}'{
+ "success": true,
+ "qrCodeBase64": "iVBORw0KGgo...",
+ "qrId": "abc123",
+ "generationTimeMs": 280,
+ "remainingCredits": 42,
+ "fromCache": false
+}| @T("Recurso", "Recurso") | +@T("Gratuito", "Gratuito") | +@T("Créditos", "Créditos") | +
|---|---|---|
| @T("QRs por chave", "QRs por clave") | +@T("5 vitalícios", "5 de por vida") | +1 @T("crédito/QR", "crédito/QR") | +
| Rate limit | +600 req/min @T("por IP", "por IP") | +|
| @T("Chaves ativas", "Claves activas") | +@T("Até 5", "Hasta 5") | +|
| @T("Formatos", "Formatos") | +PNG (base64) | +|
type)urlLink / URL
+ pix@T("Pagamento Pix", "Pago Pix")
+ wifi@T("Rede Wi-Fi", "Red Wi-Fi")
+ vcard@T("Cartão de Visita", "Tarjeta de Visita")
+ whatsappLink WhatsApp
+ emailE-mail
+ smsSMS
+ texto@T("Texto livre", "Texto libre")
+
+ @T("Escolha o plano que melhor se adapta à sua integração.",
+ "Elegí el plan porã que mejor se adapte a tu integración.")
+
+ @T("Todos os planos incluem a", "Todos los planes incluyen la")
+ API REST
+ @T("com autenticação por chave.", "con autenticación por clave.")
+
@T("para sempre", "para siempre")
+@T("por mês", "por mes")
+@T("por mês", "por mes")
+@T("por mês", "por mes")
+