Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Crie uma sessão de checkout, redirecione o cliente e confirme o pagamento
curl -X POST https://api.billing.upag.io/v1/checkout-sessions \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"successUrl": "https://example.com/success",
"cancelUrl": "https://example.com/cancel",
"paymentMethods": ["credit_card", "pix"],
"items": [
{ "priceId": "price_def456ghi", "quantity": 1 }
]
}'
import { Upag } from 'upag';
const upag = new Upag('sk_test_your_api_key');
const session = await upag.checkoutSessions.create({
successUrl: 'https://example.com/success',
cancelUrl: 'https://example.com/cancel',
paymentMethods: ['credit_card', 'pix'],
items: [{ priceId: 'price_def456ghi', quantity: 1 }],
});
console.log(session.url);
id (cs_...) e url. Redirecione o cliente para url.
upag ainda não expõe confirm — use REST:
curl -X POST https://api.billing.upag.io/v1/checkout-sessions/cs_abc123xyz/confirm \
-H "Authorization: Bearer sk_test_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"customer": "cus_ahwDXrgYvur89iPs",
"paymentMethod": "pm_abc123xyz",
"installments": 1,
"bumps": []
}'
await upag.checkoutSessions.retrieve('cs_abc123xyz').
payment.approved no servidor — o redirect sozinho não garante que você receberá a confirmação.
Exemplo de handler (Node + Express):
import express from 'express';
const app = express();
app.post('/webhooks/billing', express.json(), (req, res) => {
const { event, data } = req.body;
if (event === 'payment.approved') {
const paymentId = data.id;
// idempotente: marque pedido como pago no seu banco
console.log('Pagamento aprovado:', paymentId);
}
res.sendStatus(200);
});