Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
QR dinâmico, cliente inline e confirmação via webhook
Authorization: Bearer sk_.... Valores em centavos.
curl -X POST https://api.upag.io/v1/charges \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"type": "pix",
"amount": 9900,
"description": "Pedido #10482",
"pix": { "method": "dynamic" },
"customer": {
"name": "Maria Pagadora",
"document": { "type": "cpf", "number": "39053344705" }
}
}'
pix.qrCode na UI. Guarde id — status inicial pending.
curl -X POST https://api.upag.io/v1/charges \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"type": "pix",
"amount": 5000,
"pix": { "method": "static" }
}'
curl https://api.upag.io/v1/charges/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer sk_test_your_api_key"
status ser paid ou expired. Em produção, prefira webhook (passo 4).
curl -X POST https://api.upag.io/v1/webhooks \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"description": "Cobranças Pix",
"url": "https://example.com/webhooks/core",
"events": ["charge.paid", "charge.expired"]
}'
app.post('/webhooks/core', express.json(), (req, res) => {
const { event, data } = req.body;
if (event === 'charge.paid') {
console.log('Cobrança paga:', data.id, data.amount);
// liberar pedido / atualizar ERP
}
res.sendStatus(200);
});
curl -X POST https://api.upag.io/v1/charges \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"type": "pix",
"amount": 10000,
"pix": { "method": "dynamic" },
"customer": "660e8400-e29b-41d4-a716-446655440001",
"splits": [
{ "accountId": "880e8400-e29b-41d4-a716-446655440000", "amount": 2000 }
]
}'