PIXUP SuporteDashboard
Introdução

Início Rápido

Uma API. Todos os pagamentos.

Uma única integração conecta sua aplicação a PIX, QR Code, boleto e criptomoedas. Adicione novos métodos de pagamento sem reescrever sua operação.

Comece em 3 passos

Autentique → execute → receba webhook.
O mesmo padrão funciona para todos os métodos de pagamento.

PIX — BRL

QR Code gerado em milissegundos, disponibilidade 24/7 e confirmação por webhook em tempo real.

Boleto

Emissão, consulta e pagamento com referências rastreáveis de ponta a ponta.

Cripto

Cotação e saque para ativos habilitados, com status acompanhado automaticamente.

INTEGRE EM 3 PASSOS

1. Autentique-se

Gere as credenciais em Configurações → Credenciais. O Client Secret aparece uma única vez e deve permanecer somente no seu servidor.

HTTP
Apikey: SEU_CLIENT_ID
X-Client-Secret: SEU_CLIENT_SECRET
Content-Type: application/json

2. Execute a operação

Todas as chamadas usam HTTPS e JSON. Use uma chave de idempotência diferente em cada pagamento para impedir duplicidade em tentativas repetidas.

BASE URL
https://vexus-2-25-84-128.sslip.io/api/v1
200 Operação aceita401 Autenticação ausente403 Permissão negada422 Dados ou limite inválido429 Muitas requisições503 Provedor indisponível

3. Receba a confirmação

Responda rapidamente ao webhook e processe o evento de forma idempotente. Consulte o status pela referência quando precisar reconciliar a operação.

Seu servidorAPIProvedorWebhook

POST · PAGAMENTOS

PIX Cash-in

Crie uma cobrança PIX dinâmica e receba QR Code, payload e referência para conciliação.

POST/api/v1/cashin
cURL
curl --request POST \
  --url 'https://vexus-2-25-84-128.sslip.io/api/v1/cashin' \
  --header 'Apikey: SEU_CLIENT_ID' \
  --header 'X-Client-Secret: SEU_CLIENT_SECRET' \
  --header 'Idempotency-Key: operacao-unica-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 25.9,
    "payer_name": "Maria Silva",
    "payer_document": "52998224725",
    "description": "Pedido 1024"
}'

POST · PAGAMENTOS

PIX Cash-out

Envie um PIX por chave após validar saldo, limite e PIN transacional.

POST/api/v1/cashout
cURL
curl --request POST \
  --url 'https://vexus-2-25-84-128.sslip.io/api/v1/cashout' \
  --header 'Apikey: SEU_CLIENT_ID' \
  --header 'X-Client-Secret: SEU_CLIENT_SECRET' \
  --header 'Idempotency-Key: operacao-unica-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 20,
    "pix_key": "chave-pix",
    "pix_key_type": "EVP",
    "description": "Repasse"
}'

POST · PAGAMENTOS

Pagamento QR Code

Valide e pague um QR PIX estático ou dinâmico.

POST/api/v1/pix/qr/pay
cURL
curl --request POST \
  --url 'https://vexus-2-25-84-128.sslip.io/api/v1/pix/qr/pay' \
  --header 'Apikey: SEU_CLIENT_ID' \
  --header 'X-Client-Secret: SEU_CLIENT_SECRET' \
  --header 'Idempotency-Key: operacao-unica-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "payload": "00020126...",
    "amount": 39.9,
    "description": "Fornecedor"
}'

POST · PAGAMENTOS

Geração de boleto

Emita uma cobrança por boleto para um produto habilitado.

POST/api/v1/boleto/issue
cURL
curl --request POST \
  --url 'https://vexus-2-25-84-128.sslip.io/api/v1/boleto/issue' \
  --header 'Apikey: SEU_CLIENT_ID' \
  --header 'X-Client-Secret: SEU_CLIENT_SECRET' \
  --header 'Idempotency-Key: operacao-unica-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "product_id": "UUID_DO_PRODUTO",
    "amount": 99.9,
    "buyer_name": "Maria Silva",
    "buyer_email": "maria@example.com",
    "buyer_cpf": "52998224725",
    "buyer_address": {
        "zip_code": "01001000",
        "street_name": "Praça da Sé",
        "street_number": "100",
        "neighborhood": "Sé",
        "city": "São Paulo",
        "state": "SP"
    }
}'

POST · PAGAMENTOS

Pagamento de boleto

Consulte o beneficiário e confirme o pagamento do boleto.

POST/api/v1/boleto/pay
cURL
curl --request POST \
  --url 'https://vexus-2-25-84-128.sslip.io/api/v1/boleto/pay' \
  --header 'Apikey: SEU_CLIENT_ID' \
  --header 'X-Client-Secret: SEU_CLIENT_SECRET' \
  --header 'Idempotency-Key: operacao-unica-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "billetCode": "34191...",
    "amount": 149.9,
    "beneficiary_name": "Empresa Exemplo"
}'

POST · PAGAMENTOS

Saque cripto

Confirme um saque usando a cotação e a carteira de destino.

POST/api/v1/crypto/withdraw
cURL
curl --request POST \
  --url 'https://vexus-2-25-84-128.sslip.io/api/v1/crypto/withdraw' \
  --header 'Apikey: SEU_CLIENT_ID' \
  --header 'X-Client-Secret: SEU_CLIENT_SECRET' \
  --header 'Idempotency-Key: operacao-unica-0001' \
  --header 'Content-Type: application/json' \
  --data '{
    "quote_id": "quote_...",
    "amount_brl": 100,
    "crypto_wallet": "carteira-destino"
}'

Saldo, limites e taxas

Saldo disponível, limites operacionais e taxas são definidos pelo contrato da conta. O usuário consulta essas regras no painel; alterações administrativas ficam registradas em auditoria.

Taxas

Consulte a tela de Taxas para diferenciar Gateway e API por moeda e operação.

Boas práticas de segurança

TLS obrigatórioUse HTTPS em todas as chamadas.
IdempotênciaEvite operações duplicadas.
Restrição por IPLibere somente origens confiáveis.
AuditoriaGuarde a referência de cada chamada.

Rate Limiting

Ao receber HTTP 429, aguarde o intervalo informado, aplique recuo exponencial e não repita pagamentos sem a mesma chave de idempotência.

Transações

Use a referência local e a referência do provedor para consulta, conciliação e suporte.

Glossário

Cash-in: entrada de saldo. Cash-out: envio de saldo. Webhook: notificação assíncrona de status.

Objetos e campos

Valores monetários são informados em decimal; documentos e chaves devem ser validados antes do envio.

Integração com IA

Exporte exemplos desta documentação para seu assistente de código, mantendo credenciais e dados pessoais fora do prompt.

Limites operacionais da API

O limite padrão é de 120 requisições por minuto por credencial. Consulte X-RateLimit-Limit e X-RateLimit-Remaining; em HTTP 429, respeite Retry-After.