Pular para o conteúdo principal
O cartão de crédito é pago pelo checkout da Valora (link fixo ou POST /v1/checkouts). O número do cartão é transformado em token no navegador do cliente e nunca passa pelo seu servidor nem fica guardado na Valora. Você não precisa de certificação PCI.
A API não cria cobranças de cartão diretamente. Para vender com cartão, crie uma compra com POST /v1/checkouts com card entre as formas aceitas.

O que o cliente informa

Ciclo de vida

Quando o pagamento é recusado, card.decline_reason traz o motivo informado pelo emissor (sem dados do cartão). O cliente pode tentar de novo na mesma compra.
Para proteger a sua loja contra testes de cartões roubados, o checkout tem verificação anti-robô e limita as tentativas. Depois de 3 recusas na mesma compra, o cartão é bloqueado naquela compra e o cliente pode concluir por Pix ou boleto.

Dados do cartão no pagamento

O objeto do pagamento traz só o necessário para atendimento e conciliação:

Quando o dinheiro fica disponível

Vendas no cartão entram no saldo a liberar e passam para o disponível em parcelas mensais, a partir de 30 dias após a compra: Veja Saldo e saques.

Contestações

Se o comprador contestar a compra no banco, o pagamento muda para disputed e o valor sai do seu saldo até a disputa terminar. Veja Devoluções e contestações.