API Pix para cobrar do seu servidor.
Crie cobranças Pix, consulte o status e peça saques com credenciais por escopo e um ambiente de teste completo.
- API v3 (REST, JSON)
- Ambiente de teste
- Webhook de pagamento
Em resumo
- O que é
- A API Pix da Quibly Pay (v3, REST) cria cobranças Pix, consulta o status e faz saques para a chave do titular, chamada do seu servidor com client_id e client_secret e com ambiente de teste.
- Para quem é
- Desenvolvedores, SaaS e quem quer cobrar por Pix dentro do próprio sistema.
- Quanto custa
- Sem mensalidade: você paga só quando vende, R$ 1,00 por Pix pago e 4,99% da venda no cartão de crédito à vista.
Como funciona
Crie a credencial
No painel, em Desenvolvedor > Credenciais de API, escolha os escopos. O client_id começa com qp_test_ (teste) ou qp_live_ (produção).
Crie a cobrança
Chame POST /v3/pix/qrcode do seu servidor. A resposta traz o texto do Pix copia e cola e o transactionId.
Receba o aviso do pagamento
Cadastre um webhook. Quando o Pix é pago, a Quibly Pay envia o evento transaction.paid para a sua URL.
Consulte e confirme
Use POST /v3/pix/transaction para conferir o status. Somente PAID confirma o pagamento.
Veja no código
curl --fail-with-body https://api.quiblypay.com/v3/sandbox/pix/qrcode \
--data-urlencode "client_id=$QP_CLIENT_ID" \
--data-urlencode "client_secret=$QP_CLIENT_SECRET" \
--data-urlencode 'valor=25.00' \
--data-urlencode 'nome=Cliente Sandbox' \
--data-urlencode 'descricao=Pedido de exemplo' \
--data-urlencode "urlnoty=$QP_WEBHOOK_URL"Trecho da documentação (Primeira cobrança). As credenciais ficam em variáveis de ambiente do servidor, nunca no navegador.
{
"statusCode": 200,
"qrcode": "PIX_COPY_AND_PASTE_TEXT",
"checkout_url": "",
"transactionId": "TRANSACTION_ID",
"amount": 25
}qrcode é o texto do Pix copia e cola, não uma imagem. Para mandar o comprador a uma página de pagamento hospedada, use uma sessão de checkout.
{
"statusCode": 200,
"transactionId": "TRANSACTION_ID",
"status": "PENDING",
"amount": 25,
"created_at": "2026-10-04 12:00:00"
}Quando o status é PAID, a resposta traz também net_amount e tax. Somente PAID confirma o pagamento.
O que você tem
Cobrança Pix por API
POST /v3/pix/qrcode devolve o Pix copia e cola e o identificador da transação.
Consulta de transação
POST /v3/pix/transaction informa PENDING, PAID ou CANCELLED e, quando pago, o valor líquido e a tarifa.
Credenciais com escopo
cashin cria cobranças, read consulta e cashout faz saques. Cada credencial é de teste ou de produção.
Ambiente de teste
Os mesmos endpoints em /v3/sandbox, com simulação de pagamento para disparar o webhook sem dinheiro real.
Webhook de pagamento
Aviso por transaction.paid, com segredo no cabeçalho e assinatura HMAC opcional para validar a origem.
IPs autorizados
Restrinja as chamadas aos IPs do seu servidor. Alterar chaves e IPs pede confirmação por MFA.
Saque pela API
Exige escopo cashout, MFA ativo e IP autorizado, com Idempotency-Key. O destino é a chave Pix do próprio titular da conta.
Formato simples
Corpo em JSON ou formulário, valores em reais como "25.00" e respostas sempre em JSON, inclusive nos erros.
Para quem é
Quem tem sistema próprio
Gere a cobrança pelo seu back-end e libere o pedido quando o webhook confirmar o pagamento.
Quem integra uma loja ou plataforma
Use o ambiente de teste para validar o fluxo inteiro antes de trocar para a credencial de produção.
Quem automatiza o financeiro
Consulte transações e peça saques por código, respeitando MFA, IP autorizado e os limites da conta.
Perguntas frequentes
Como me autentico?
Cada chamada é um POST com client_id e client_secret no corpo, sem token Bearer. O client_id começa com qp_live_ (produção) ou qp_test_ (teste). Chame sempre do servidor e nunca exponha o segredo no navegador.
Existe ambiente de teste?
Sim. Os endpoints de /v3/sandbox usam credenciais qp_test_ e um QR simulado que não pode ser pago em banco. O endpoint de simulação confirma o pagamento e gera o webhook.
O QR code vem como imagem?
Não. O campo qrcode traz o texto do Pix copia e cola. Gere a imagem do QR no seu sistema, se quiser exibi-la.
Posso repetir a chamada que cria a cobrança?
Com cuidado. A criação de cobrança não usa Idempotency-Key: repetir a chamada pode criar outra cobrança. Salve o resultado e investigue chamadas sem resposta antes de tentar de novo. O saque aceita Idempotency-Key.
Como sei que o Pix foi pago?
Pelo webhook transaction.paid e pela consulta em POST /v3/pix/transaction. Somente o status PAID confirma o pagamento.
Posso sacar para qualquer chave Pix?
Não. O saque vai só para a chave Pix do titular da conta (CPF ou CNPJ) e exige escopo cashout, MFA ativo, IP autorizado e saldo.
Veja também
Comece grátis, sem mensalidade.
Crie a conta e configure o seu primeiro produto. Você só paga quando vende.