Setup Intents
Confirm a Setup Intent
Confirma um setup intent.
Confirma o
setup_intent usando o payment_method já definido nele, um
payment_method informado na chamada, ou um cartão tokenizado no cliente. Ao
confirmar, o método passa a ser o método padrão do customer.
Se o setup intent estiver ligado a uma subscription em trial pelo campo
pending_setup_intent, a confirmação também define o
default_payment_method dessa subscription, limpa o setup intent pendente e
emite subscription.updated.
ID do setup intent (
seti_*).ID de um payment method já salvo (
pm_*). Use este campo quando o método já
existe e ainda não foi definido no setup intent.Token de cartão de uso único gerado no cliente. Use quando quer salvar um novo
cartão.
ID de cartão já salvo que pertence a este customer. Alternativa a
token_id. A propriedade é validada antes de salvar; um cartão que não pertence ao customer é recusado com 402 card_error. Prefira token_id no fluxo padrão.Customer. Obrigatório se o setup intent foi criado sem customer.
Resposta
200 OK com status: "succeeded" e payment_method apontando para o
pm_* salvo.
Se a confirmação falhar ao salvar o cartão, o setup intent volta para
requires_payment_method, preenche last_setup_error e emite
setup.intent.failed.