{"uid":"cap_RFO3xbMdVu91UhpO0D0fZ","slug":"miniframe-pix-br-code-generator-2c572b00","name":"MiniFrame Pix BR Code Generator","description":"Use when someone needs to receive money in Brazil — an invoice, a split bill, a donation, a checkout. Builds a Pix BR Code (\"Copia e Cola\" string payable in any Brazilian bank app) plus a QR PNG, per the Central Bank spec; the key is not stored. JSON body: key and merchant_name required; amount, merchant_city, txid, description optional. Returns brcode and qr_png_base64.","url":"https://tools.miniframe.com.br/pix/brcode","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"key":{"type":"string","description":"Pix key: CPF/CNPJ, email, phone (+55...) or random key."},"txid":{"type":"string","description":"Reference label, max 25 chars (optional)."},"amount":{"type":"number","description":"Amount in BRL (optional; omit for an open-value code)."},"description":{"type":"string","description":"Message to the payer (optional)."},"merchant_city":{"type":"string","description":"Receiver city, max 15 chars (optional, default BRASIL)."},"merchant_name":{"type":"string","description":"Receiver name, max 25 chars."}}},"responseSchema":{"type":"json","example":{"brcode":"00020126...5802BR5912Loja Exemplo6009SAO PAULO6304ABCD","qr_png_base64":"iVBORw0KGgo..."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1bsAwSvwnuu5jEqDuvYnI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates a Brazilian Pix payment BR Code ('Copia e Cola' string) and QR PNG image per Central Bank spec, enabling instant payment receipt via any Brazilian bank app.","exampleAgentPrompt":"Generate a Pix BR Code and QR image so I can receive R$250 from a client — my Pix key is minha@empresa.com.br, merchant name is 'Loja Exemplo', city is 'São Paulo', and the description should say 'Pedido #1042'.","exampleUseCases":[{"title":"Charity fundraiser donation QR code","prompt":"I'm collecting donations for a local shelter and need a Pix QR code people can scan to contribute — set it up as an open-value donation so donors can give whatever they want, use my CPF key, put 'Abrigo dos Animais' as the merchant name, and mark it as 'Donation' in the description."},{"title":"E-commerce checkout payment receipt","prompt":"I'm building a checkout flow for my online store and need to generate a Pix BR Code for each order — for the next one, amount is R$89.90, my Pix key is my email contato@loja.com.br, business name is 'TechStore Brasil', city is 'Rio de Janeiro', and reference it as 'Order #5847'."},{"title":"Freelance invoice payment collection","prompt":"I just finished a project for a client and want to send them a Pix invoice they can pay instantly — I need the BR Code and QR image, my Pix key is my phone number, my business name is 'Consultoria Digital', the amount due is R$1200, it's from 'Brasília', and label it 'Invoice - Web Development Services'."}],"resultDescription":"Returns a JSON object containing: `brcode` (the Pix 'Copia e Cola' EMV string payable in any Brazilian bank app) and `qr_png_base64` (a base64-encoded PNG of the scannable QR code). The key is not stored server-side.","failureModes":["Invalid or malformed Pix key format — returns error if key does not match CPF/CNPJ/email/phone/random UUID patterns","merchant_name or key missing — required fields; omitting either returns a 400-level error","txid exceeds 25 characters — truncation or rejection depending on implementation","merchant_city exceeds 15 characters — may be truncated or rejected","Non-BRL amount or negative amount — may produce an invalid BR Code","Payment processing error or x402 payment failure — call not executed if USDC micropayment fails"],"whenToPreferThis":"Use this endpoint when you need to programmatically generate a Pix payment code or QR for any Brazilian payment scenario — invoices, donations, bill splits, or e-commerce checkouts — and want a Central Bank spec-compliant BR Code and QR PNG without storing the Pix key. Prefer this over generic QR generators because it produces a fully valid Pix EMV payload usable in any Brazilian banking app.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:38:45.946Z","isFirstParty":false}