Checkout com cartão junto dos pagamentos por carteira, recebendo USDC na Base na carteira da fatura.
1. Confira sua conta Coinflow
Use Wholly Crypto 9.0.0 ou mais recente. Peça à Coinflow para aprovar seu negócio e ativar a liquidação de USDC na Base em endereços de recebimento por fatura. Em produção, o cliente precisa pagar as taxas do provedor, sem reservas nem deduções na liquidação.
Disponibilidade, verificação de identidade, limites e taxas dependem da sua conta Coinflow e da localização do cliente. Confira o preço final na Coinflow antes de pagar.
2. Conecte e teste no sandbox
Abra Settings → Fiat payments. Salve seu merchant ID da Coinflow, API key e Webhook Validation Key. Adicione a URL de callback exibida na Coinflow e confira a conexão. Mantenha as credenciais no servidor; nunca compartilhe chaves de carteiras.
O checkout sandbox do administrador é um teste separado de 10 USD com endereço de recebimento sandbox. Ele não paga uma fatura de produção. Uma conexão bem-sucedida, sozinha, não confirma a elegibilidade do negócio ou do pagamento.
3. Ative USDC na Base na sua loja
Faça backup da carteira do projeto e confira o scanner da Base. Em Store → Payment methods, aceite USDC nativo na Base e ative cartões. Use USDC, não USDbC nem USDC na Ethereum. Uma fatura sem USDC na Base não oferece cartão.
4. Teste um pequeno pagamento real
Depois da aprovação da Coinflow, ative produção e crie uma fatura normal, manualmente ou pela API. Escolha cartão no checkout. A fatura mantém a moeda, cotação e spread originais; a Coinflow mostra ao cliente as taxas finais e a conversão antes do pagamento.
5. Verifique o recebimento antes de entregar
Uma fatura só é liquidada quando o USDC chega e atende à sua política de confirmações da blockchain. Uma autorização do cartão ou o retorno ao checkout não comprova o pagamento.
Confira os detalhes de Card payment da fatura e a transação USDC na Base. Mantenha seu fluxo normal com IPN ou webhooks assinados. Aja com invoice.settled e confira requires_review; nunca entregue só pelo retorno do navegador. Pagamentos atrasados ou conflitantes podem precisar de revisão.
6. Faça sweeps e trate exceções
Mantenha ETH na Base para enviar o USDC recebido à sua carteira fria ou configure financiamento de gas e sweeps automáticos. Trate reembolsos de cartão e contestações na Coinflow. Nunca devolva cripto ao remetente da transação do provedor. Confira disputas em Needs attention.