API V1 · Ambiente de teste

Integre cobranças Pix sem complexidade.

Valores são enviados em centavos. Cada criação exige uma chave única para evitar cobranças duplicadas.

Autenticação

Envie sua chave secreta no cabeçalho Authorization. Gere uma chave diferente para cada sistema.

Authorization: Bearer px_test_...

Criar cobrança

POST

O retorno inclui o endereço do checkout, QR Code e código Pix copia e cola.

curl -X POST https://pixpag.site/api/public/v1/charges   -H "Authorization: Bearer px_test_SUA_CHAVE" \
  -H "Idempotency-Key: pedido-8472" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 4890,
    "description": "Pedido 8472",
    "external_id": "8472",
    "customer": {
      "name": "Cliente Teste",
      "email": "cliente@exemplo.com",
      "document": "12345678901"
    }
  }'

Consultar cobrança

GET

/api/public/v1/charges?id=ID_DA_COBRANCA

Confirmação

payment.pending — Pix aguardando pagamento

payment.paid — Pix confirmado

payment.expired — cobrança vencida

payment.refunded — valor devolvido