Cria uma cobrança com forma de pagamento em cartão de crédito.
Use esta operação para criar a cobrança e direcionar o pagador à invoiceUrl ou para processar o cartão diretamente pela API. No processamento direto, informe os dados do cartão e do titular ou um creditCardToken válido para o cliente.
Quando o cartão é processado durante a criação, a tentativa ocorre imediatamente, independentemente de dueDate. Se a transação não for autorizada, a cobrança não é persistida e a API retorna HTTP 400.
O creditCardToken substitui creditCard e creditCardHolderInfo e só pode ser utilizado em cobranças do cliente para o qual foi gerado. Em Produção, a tokenização depende de habilitação para a conta.
Configure timeout mínimo de 60 segundos para esta requisição quando houver processamento do cartão, reduzindo o risco de tentativas duplicadas em caso de demora na resposta.
Para cobranças parceladas, são permitidas até 21 parcelas para Visa e Mastercard e até 12 parcelas para as demais bandeiras.
Quando authorizeOnly for true, o valor é apenas reservado no limite do cartão e a cobrança fica com status AUTHORIZED. A captura deve ser realizada posteriormente pelo endpoint de captura da pré-autorização. O prazo padrão da reserva é de 3 dias e, para contas elegíveis, pode ser configurado para até 25 dias; após o prazo, a reserva é revertida automaticamente.
Processamento direto do cartãoSe sua aplicação captura dados do cartão, utilize HTTPS. Sem SSL, a conta pode ser bloqueada para transações com cartão de crédito.
Informe em
remoteIpo IP do dispositivo do pagador, e não o IP do servidor da integração.
Acompanhamento do pagamentoA criação da cobrança não representa a disponibilização definitiva do valor. Acompanhe o processamento pelos Webhooks de cobranças, incluindo cenários de análise de risco, confirmação, recebimento ou recusa de captura.