PIX
Quick Reference
WhatPagamentos instantâneos PIX
WhyCusto zero, liquidação instantânea 24/7, QR code — o método de pagamento que mais cresce no Brasil
Reading Time10 min
DifficultyBeginner
PrerequisitesAutenticação → Ambiente
Por que PIX
| Vantagem | Detalhe |
|---|---|
| Liquidação instantânea | 24/7/365 — os fundos se movem em segundos |
| Custo zero ou quase zero | Sem taxas de bandeira; o preço do PIX costuma ser menor que o de cartões |
| Maior alcance | Mais de 150 milhões de usuários no Brasil |
| Sem chargeback | Pagamento push irrevogável |
| UX simples | Escaneie o QR ou copie a string PIX |
Ciclo de vida do PIX
Fluxo de pagamento
Criar uma cobrança PIX
- cURL
- Python
- JavaScript
curl -X POST https://core-manager.a55.tech/api/v1/bank/wallet/charge/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"wallet_uuid": "00000000-0000-0000-0000-000000000000",
"merchant_id": "11111111-1111-1111-1111-111111111111",
"payer_name": "João Silva",
"payer_email": "joao.silva@example.com",
"payer_tax_id": "39999999999",
"payer_cell_phone": "+5511988887777",
"installment_value": 150,
"installment_count": 1,
"items": [{"name":"Running Shoes","quantity":1,"total_amount":150,"unit_amount":150,"sku":"SHOE-001","code":"RS001"}],
"payer_address": {"street":"Av. Paulista","address_number":"1000","complement":"Apto 42","neighborhood":"Bela Vista","city":"São Paulo","state":"SP","postal_code":"01310-100","country":"BR"},
"currency": "BRL",
"due_date": "2026-12-31T23:59:59Z",
"description": "Order via PIX",
"type_charge": "pix",
"webhook_url": "https://yoursite.com/webhook",
"redirect_url": "https://yoursite.com/confirmation"
}'
import requests
charge = requests.post(
"https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
headers={"Authorization": f"Bearer {access_token}", "Content-Type": "application/json"},
json={
"wallet_uuid": "00000000-0000-0000-0000-000000000000",
"merchant_id": "11111111-1111-1111-1111-111111111111",
"payer_name": "João Silva",
"payer_email": "joao.silva@example.com",
"payer_tax_id": "39999999999",
"payer_cell_phone": "+5511988887777",
"installment_value": 150,
"installment_count": 1,
"items": [{"name": "Running Shoes", "quantity": 1, "total_amount": 150, "unit_amount": 150, "sku": "SHOE-001", "code": "RS001"}],
"payer_address": {"street": "Av. Paulista", "address_number": "1000", "complement": "Apto 42", "neighborhood": "Bela Vista", "city": "São Paulo", "state": "SP", "postal_code": "01310-100", "country": "BR"},
"currency": "BRL",
"due_date": "2026-12-31T23:59:59Z",
"description": "Order via PIX",
"type_charge": "pix",
"webhook_url": "https://yoursite.com/webhook",
"redirect_url": "https://yoursite.com/confirmation",
},
)
data = charge.json()
qr_png = data["pix_payload"]["qr_code"]
copy_paste = data["pix_payload"]["payload"]
const response = await fetch(
"https://core-manager.a55.tech/api/v1/bank/wallet/charge/",
{
method: "POST",
headers: {
Authorization: `Bearer ${accessToken}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
wallet_uuid: "00000000-0000-0000-0000-000000000000",
merchant_id: "11111111-1111-1111-1111-111111111111",
payer_name: "João Silva",
payer_email: "joao.silva@example.com",
payer_tax_id: "39999999999",
payer_cell_phone: "+5511988887777",
installment_value: 150,
installment_count: 1,
items: [{ name: "Running Shoes", quantity: 1, total_amount: 150, unit_amount: 150, sku: "SHOE-001", code: "RS001" }],
payer_address: { street: "Av. Paulista", address_number: "1000", complement: "Apto 42", neighborhood: "Bela Vista", city: "São Paulo", state: "SP", postal_code: "01310-100", country: "BR" },
currency: "BRL",
due_date: "2026-12-31T23:59:59Z",
description: "Order via PIX",
type_charge: "pix",
webhook_url: "https://yoursite.com/webhook",
redirect_url: "https://yoursite.com/confirmation",
}),
}
);
const { pix_payload, charge_payment_url } = await response.json();
Exibir o QR code
| Campo | Uso |
|---|---|
pix_payload.qr_code | PNG em Base64 — renderize como data:image/png;base64,… |
pix_payload.payload | String EMV copia e cola |
pix_payload.expiration_date | Mostre prazo ou contagem regressiva |
charge_payment_url | Página de pagamento hospedada com QR |
QR e copia e cola
Ofereça a imagem do QR e a string copia e cola. Usuários de celular no mesmo aparelho não conseguem escanear a própria tela.
Exemplo de resposta
{
"charge_uuid": "81f0045c-301a-45c4-96bc-5395f7cf35f9",
"currency": "BRL",
"type": "pix",
"status": "issued",
"pix_payload": {
"qr_code": "iVBORw0KGgoAAAANSUh…",
"payload": "00020126580014br.gov.bcb.pix…",
"expiration_date": "2026-01-15 18:30:00.000000"
},
"charge_payment_url": "https://pay.a55.tech/charge/81f0045c-301a-45c4-96bc-5395f7cf35f9"
}
Ciclo de vida do status
| Status | Descrição |
|---|---|
issued | QR gerado; aguardando pagamento |
paid | Confirmado pela rede PIX |
canceled | Expirou ou foi cancelado antes do pagamento |
error | Erro de geração ou processamento |
refunded | Estorno concluído |