Visão Geral - Transações
A QivoPay oferece uma API completa para processar transações de pagamento com múltiplos gateways. Gerencie pagamentos únicos com segurança, acompanhe status em tempo real e integre com os principais processadores do mercado.
Nossa API suporta cartão de crédito, PIX e boleto, com recursos avançados como melhor roteamento de gateway, webhooks automáticos e exportação de dados.
Gateways Integrados
Mercado Pago
Stripe
ASAAS
Pagar.me
Estados da Transação
Pendente (pending)
Transação criada e aguardando processamento do pagamento.
Processando (processing)
Pagamento sendo processado pelo gateway.
Paga (paid)
Pagamento confirmado e processado com sucesso.
Falhou (failed)
Transação rejeitada por dados inválidos ou falta de saldo.
Cancelada (canceled)
Transação cancelada antes do processamento.
Reembolsada (refunded)
Valor devolvido ao cliente após processamento.
Recursos Principais
Múltiplos Métodos de Pagamento
Aceite cartão de crédito (parcelado ou à vista), PIX instantâneo e boleto bancário. O Pagar.me suporta apenas cartão de crédito.
Melhor Roteamento de Gateway
Use o parâmetro useBestGateway
para automaticamente selecionar o gateway com menor taxa para cada transação.
Webhooks e Notificações
Receba notificações automáticas sobre mudanças de status, confirmações de pagamento e falhas através de webhooks configuráveis.
Reembolsos e Cancelamentos
API completa para processar reembolsos totais ou parciais e cancelar transações pendentes diretamente pela integração.
Métodos de Pagamento por Gateway
Gateway | Cartão | PIX | Boleto |
---|---|---|---|
Mercado Pago | ✓ | ✓ | ✓ |
Stripe | ✓ | ✓ | ✓ |
ASAAS | ✓ | ✓ | ✓ |
Pagar.me | ✓ | ✗ | ✗ |
Endpoints Disponíveis
/transaction
/transaction/create-pix
/transaction
/transaction/:id
/transaction/refund/:id
/transaction/cancel/:id
Autenticação
Todas as requisições devem incluir sua API Key no header:
x-api-key: sua_api_key_aqui
URL Base da API
https://api.qivopay.com.br