Skip to main content
Uma única API Upag cobre contas, Pix, cartão, checkout, assinaturas e transferências. Neste guia você cria uma cobrança Pix e consulta o status, usando uma chave de teste (sk_test_...). Valores monetários são inteiros em centavos. Identificadores são UUIDs. Veja Convenções.
Chaves sk_test_... usam o sandbox em https://api.upag.dev/v1. Qualquer outra chave usa produção em https://api.upag.io/v1. Os SDKs escolhem o host sozinhos a partir da chave. Detalhes em Autenticação.

1. Instalar o SDK (opcional)

O SDK não é obrigatório: qualquer cliente HTTP com Authorization: Bearer funciona. Para Node.js:
No browser use upag-js com a chave publicável (pk_...).

2. Criar a cobrança

Mostre pix.qrCode (copia-e-cola) ao pagador e guarde o id. O status inicial é pending.

3. Consultar o status

Quando status for paid, o Pix foi recebido. Em produção, prefira webhooks a polling.
No sandbox você pode simular resultados. Veja o Simulador.

Próximos passos

Autenticação

Chaves, permissões e hosts.

Cobrança Pix

QR dinâmico, estático e splits.

Cartão com 3DS

Tokenização no browser e autenticação.

Checkout hospedado

Links de pagamento e sessões de checkout.

Assinatura recorrente

Produtos, preços e faturas.

SDKs

upag (Node.js) e upag-js (browser).