Ao criar uma cobrança com a forma de pagamento cartão de crédito, é possível redirecionar o cliente para a URL da fatura (invoiceUrl) afim de que ele informe os dados do cartão através da interface do Asaas, ou os dados do cartão e do portador podem ser enviados na requisição de criação para que o pagamento já seja processado.

Para tal, ao executar a requisição de criação da cobrança, basta enviar os dados do cartão de crédito juntamente com os dados do titular através dos objetos creditCard e creditCardHolderInfo. É importante que os dados do titular sejam exatamente os mesmos cadastrados no banco emissor do cartão, caso contrário a transação poderá ser negada por suspeita de fraude.

Se a transação for autorizada a cobrança será criada e o Asaas retornará HTTP 200. Caso contrário
a cobrança não será persistida e será retornado HTTP 400.

Em Sandbox as transações são aprovadas automaticamente, caso queira simular um erro é necessário informar o cartão de crédito de número 5184019740373151 (Mastercard) ou 4916561358240741 (Visa).

Tokenização de cartão de crédito

• Ao realizar uma primeira transação para o cliente com cartão de crédito, a resposta do Asaas lhe devolverá o atributo creditCardToken.
• Em posse dessa informação, nas próximas transações, o atributo creditCardToken pode substituir os objetos creditCard e creditCardHolderInfo e ser informado diretamente na raiz da requisição, não necessitando assim que os objetos sejam informados novamente.

🚧

Atenção:

• Independente da data de vencimento informada, a captura (cobrança no cartão do cliente) será efetuada no momento da criação da cobrança.
• Caso você opte por capturar na interface do seu sistema os dados do cartão do cliente, é
  obrigatório o uso de SSL (HTTPS), caso contrário sua conta pode ser bloqueada para transações via
  cartão de crédito.
• Para se evitar timeouts e decorrentemente duplicidades na captura, recomendamos a configuração de um timeout mínimo de 60 segundos para este request.

Criar cobrança no cartão de crédito com Pré-Autorização

Uma Pré-Autorização funciona como uma reserva de saldo do cartão do cliente, como garantia de que o valor previsto estará disponível.

Ao invés de efetivamente debitar o valor, é realizada uma reserva fazendo com que esse valor deixe de fazer parte do limite do cartão até que seja efetivada a captura ou que a Pré-Autorização expire.

A diferença entre a criação de cobrança Pré-Autorizada com uma cobrança de captura imediata, é apenas no atributo authorizeOnly que deve ser enviado com valor true, indicando assim que para esta cobrança será realizada apenas a Pré-Autorização.

📘

• Uma cobrança Pré-Autorizada será estornada automaticamente após 3 dias na ausência de sua captura.
• Para cancelar a Pré-Autorização antes dos 3 dias, deve ser usado o recurso de Estornar Cobrança.
• A cobrança Pré-Autorizada será criada com o status "AUTHORIZED" em caso de sucesso.
• Em Sandbox as capturas são aprovadas automaticamente. Caso queira simular um erro, basta utilizar uma cobrança que não foi criada usando a Pré-Autorização ou com status diferente de Autorizada.