PIX
Quick Reference
WhatPIX instant payments
WhyZero cost, 24/7 instant settlement, QR code — Brazil's fastest growing payment method
Reading Time10 min
DifficultyBeginner
PrerequisitesAuthentication → Environment
Why PIX
| Advantage | Detail |
|---|---|
| Instant settlement | 24/7/365 — funds move in seconds |
| Zero or near-zero cost | No card scheme fees; PIX pricing is typically lower than cards |
| Highest reach | 150M+ users in Brazil |
| No chargebacks | Irrevocable push payment |
| Simple UX | Scan QR or copy the PIX string |
PIX lifecycle
Payment flow
Create a PIX charge
- 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();
Display the QR code
| Field | Usage |
|---|---|
pix_payload.qr_code | Base64 PNG — render as data:image/png;base64,… |
pix_payload.payload | EMV copy-paste string |
pix_payload.expiration_date | Show deadline or countdown |
charge_payment_url | Hosted payment page with QR |
QR and copy-paste
Offer both the QR image and the copy-paste string. Mobile users on the same device cannot scan their own screen.
Response example
{
"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"
}
Status lifecycle
| Status | Description |
|---|---|
issued | QR generated; awaiting payment |
paid | Confirmed by the PIX network |
canceled | Expired or canceled before payment |
error | Generation or processing error |
refunded | Refund completed |