API CONDESPAY / V1 / PRODUÇÃO
Integre pagamentos
sem perder o controle.
A API CondesPay usa JSON, autenticação por credenciais próprias e idempotência em todas as operações críticas.
Introdução
Base URL: https://pixpay.cash/api/v1. Tokens de produção movimentam dinheiro real (Pix in e Pix out).
Autenticação
Envie o token no cabeçalho Authorization: Bearer pps_... . Não existe client ID: o token já identifica sua conta. Para Pix out, o token precisa do escopo withdrawals:write (botão "Criar token (receber e enviar Pix)").
Ambientes
Tokens de produção operam com dinheiro real. Tokens sandbox apenas simulam.
Criar cliente
Cadastre o pagador antes de iniciar uma cobrança.
Criar cobrança PIX
Crie uma cobrança com valor em centavos, cliente e external_id único.
curl -X POST https://api.SEU_DOMINIO/v1/pix/charges \
-H "Idempotency-Key: order_123" \
-H "Content-Type: application/json" \
-d '{"amount":25000,"customer":"cus_..."}'Consultar PIX
Consulte pelo identificador público e acompanhe os estados da cobrança.
Saques
Saques Pix reais (Pix out) estão disponíveis em produção: POST /withdrawals com amount em centavos, pix_key_type (cpf, cnpj, email, phone, random), pix_key e cabeçalho Idempotency-Key. Consulte o status em GET /withdrawals/{id} (processing, paid ou failed) ou, sem o id, em GET /withdrawals?idempotency_key=SUA-CHAVE. Se o saque for recusado depois de registrado, o erro traz em data o id e a situação do saque. Meio de pagamento: GET /payment-provider mostra o ativo; POST /payment-provider com {"provider":"hoopay"} ou {"provider":"xgate"} troca (token com withdrawals:write). O saldo de cada meio só sai por ele mesmo.
curl -X POST https://pixpay.cash/api/v1/withdrawals \
-H "Authorization: Bearer pps_..." \
-H "Idempotency-Key: saque-123" \
-H "Content-Type: application/json" \
-d '{"amount":100,"pix_key_type":"cpf","pix_key":"12345678909"}'Webhooks
Eventos são assinados e cada tentativa de entrega fica registrada.
Erros
Todos os erros seguem um envelope consistente e incluem request_id.
{
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Saldo insuficiente.",
"request_id": "req_..."
}
}Idempotência
Envie Idempotency-Key. Repetições equivalentes retornam a operação existente.