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.

01

Introdução

Base URL: https://pixpay.cash/api/v1. Tokens de produção movimentam dinheiro real (Pix in e Pix out).

02

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)").

03

Ambientes

Tokens de produção operam com dinheiro real. Tokens sandbox apenas simulam.

04

Criar cliente

Cadastre o pagador antes de iniciar uma cobrança.

05

Criar cobrança PIX

Crie uma cobrança com valor em centavos, cliente e external_id único.

cURL
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_..."}'
06

Consultar PIX

Consulte pelo identificador público e acompanhe os estados da cobrança.

07

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"}'
08

Webhooks

Eventos são assinados e cada tentativa de entrega fica registrada.

09

Erros

Todos os erros seguem um envelope consistente e incluem request_id.

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Saldo insuficiente.",
    "request_id": "req_..."
  }
}
10

Idempotência

Envie Idempotency-Key. Repetições equivalentes retornam a operação existente.