Transações

Veja cobranças bem-sucedidas, emita reembolsos e acompanhe contestações na área de Orders do painel admin do seu app.

O painel admin do seu app lista todas as cobranças vinculadas a ele — na área Orders — com status, valor, moeda, cliente e referências de produto. A partir daqui, você pode emitir reembolsos sem sair do app.

Estados de transação

Status	Significado
succeeded	Pagamento capturado com sucesso
pending	Aguardando captura ou confirmação assíncrona
failed	Tentativa de cobrança falhou
refunded	Totalmente reembolsado
partially_refunded	Parte do valor foi reembolsada
disputed	O cliente contestou a cobrança junto ao banco

Reembolsos

Encontre a transação na aba Payments e clique no botão Refund na linha correspondente. Você pode reembolsar o valor total ou parcial, com um motivo:

• Duplicate — cobrança duplicada acidentalmente
• Fraudulent — a cobrança não foi autorizada
• Requested by customer — o cliente solicitou o reembolso

Reembolsos só podem ser emitidos em transações com status succeeded ou partially_refunded. Transações contestadas devem ser gerenciadas pelo dashboard do Stripe.

Transações de assinatura não podem ser reembolsadas por esse fluxo — cancele a assinatura. Pagamentos avulsos são elegíveis, incluindo pagamentos offline (dinheiro, transferência bancária, terminal) que você registrou — não apenas cobranças via cartão no Stripe.

O reembolso é creditado no método de pagamento original do cliente via Stripe (prazo típico de liquidação: 5 a 10 dias úteis).

O que é registrado por transação

• id
• customerId e productId (nullable — ausente em transações exclusivas de assinatura)
• amountCents e currency
• status (acima)
• refundAmountCents (se houver)
• createdAt

Em uma venda de loja virtual, productId aponta para o produto de Commerce criado a partir de uma entrada de conteúdo vendável — assim, um pagamento pode ser rastreado até o item exato do catálogo que o comprador adquiriu.

Contestações (chargebacks)

Se um cliente contestar uma cobrança junto ao banco, o status da transação muda para disputed. O Stripe gerencia o fluxo de resposta à contestação — você receberá um e-mail e poderá enviar evidências pelo dashboard do Stripe.

Um fluxo nativo de resposta a contestações dentro do builder do Proyecta está no roadmap.

Em breve

• Linha do tempo de eventos por transação — veja cada mudança de estado
• Exportação em massa do histórico de transações
• Resposta nativa a contestações diretamente na interface Admin > Commerce