Orquestração de pagamentos

#Visão Geral

A Selectwin cuida de todo o processamento do pagamento por trás de uma única integração: você envia uma requisição e recebe um resultado, com cartão, PIX e boleto sob o mesmo contrato, os mesmos objetos e os mesmos webhooks.

Tudo o que acontece entre a sua chamada e o resultado é responsabilidade nossa e não muda nada no seu código.

---

#O que você ganha

• Uma integração para todos os métodos — crédito, PIX e boleto usam o mesmo POST /v1/transactions, o mesmo objeto de transação e a mesma família de eventos.
• Resultado único e confiável — o desfecho chega pelo status da transação e pelos webhooks (transaction.approved, transaction.failed, …), independentemente do que tenha sido necessário para chegar até ele.
• Instabilidade passageira é problema nosso — falha de rede ou tempo esgotado no processamento é tratada pela Selectwin, sem cobrança em dobro. Você não precisa implementar retentativa. A recusa chega com o motivo, pelo status e pelo webhook.
• Conciliação unificada — recebíveis, taxas, saldo, reembolsos e disputas aparecem em um conjunto único de recursos, no mesmo formato, para qualquer método de pagamento.
• Sem custo adicional — a orquestração está incluída em todos os planos.

---

#O que isso significa para a sua integração

1. Crie a cobrança e acompanhe o resultado. A criação é assíncrona: POST /v1/transactions responde com a transação registrada, e o desfecho chega depois. Veja Recusas de Pagamento.
2. Não faça polling. Assine os webhooks — eles são a fonte do resultado (Proibição de Polling).
3. Envie o cabeçalho X-Idempotency-Key. Repetir a mesma requisição com a mesma chave, dentro de 24 horas, nunca vira cobrança dupla (Idempotência).
4. Leia o status e o error.code, nunca o texto da mensagem (Tratamento de Erros).

---

#Perguntas Frequentes

#A orquestração gera custos adicionais?

Não. Está incluída em todos os planos.

#A orquestração afeta o tempo de resposta?

Não de forma perceptível na sua integração: a criação da cobrança responde de imediato e o resultado chega por webhook.

#Como acompanho o processamento de uma transação?

Pelo status da transação, pelos webhooks e pelo timeline do objeto, que registra as mudanças de status. O campo payment.acquirerTransactionNumber traz a referência do processamento para conciliação e atendimento.