Skip to main content
Use um Payment Intent para movimentar dinheiro. Use um Cadastro de cartão (setup_intent) para salvar um cartão e cobrar depois.
Um Cadastro de cartão não possui amount, não cria Charge, não reserva limite e não movimenta dinheiro. Depois que ele termina em succeeded, use o Payment Method salvo em um Payment Intent ou em uma assinatura.

​
Quando usar Payment Intent

Use um Payment Intent quando a operação tem valor, moeda e resultado financeiro. Ele acompanha a cobrança até um estado terminal e aponta a tentativa mais recente em latest_charge. O método determina o próximo passo: Consulte Payment Intents para estados, exemplos e relações com Charges e Transactions.

​
Quando cadastrar o cartão

Use um cadastro de cartão (setup_intent) quando o cliente autoriza guardar um cartão para uso posterior. O fluxo é:
  1. criar ou recuperar o customer;
  2. iniciar o cadastro;
  3. tokenizar o cartão no navegador;
  4. concluir o cadastro;
  5. guardar o payment_method retornado para cobranças futuras.
Uma falha não cria cobrança. O intent volta para requires_payment_method, preenche last_setup_error e permite coletar outro cartão. Consulte Salvar cartão para cobrar depois para implementar o fluxo completo.

​
Dois exemplos

​
Cobrar agora

Seu cliente concluiu um pedido de R$ 99. Crie um Payment Intent de 9900 centavos, defina o método e confirme. Libere o pedido somente quando o intent estiver em succeeded.

​
Salvar agora e cobrar depois

Seu cliente iniciou um trial. Conclua o cadastro com o token gerado no navegador. Quando o trial terminar, a assinatura usa o payment_method salvo na cobrança automática. Em uma cobrança avulsa futura, seu backend cria um Payment Intent usando esse mesmo cartão.

​
Próximos passos

Payment Intents

Crie, confirme, acompanhe e cancele uma cobrança.

Cadastro de cartão

Salve um cartão para cobrar depois.