payment_method representa um método de pagamento salvo — hoje, um cartão. Ele guarda só o que é seguro manter para cobrar de novo no futuro: a bandeira, os quatro últimos dígitos, o mês e o ano de validade e o nome do portador. O número completo e o código de segurança nunca são armazenados nem retornados; eles existem apenas em trânsito, no momento em que o cartão é tokenizado.
Ele fica ligado a um customer para ser reaproveitado nas cobranças seguintes, em vez de pedir o cartão de novo a cada compra. Uma plataforma pode também compartilhar um cartão entre organizações conectadas, após cadastrar o cliente de destino com o mesmo CPF/CNPJ. O método nasce quando um checkout hospedado ou um fluxo de salvamento tokeniza o cartão, e passa a ficar disponível para anexar a um customer como método padrão. Anexar e desanexar não apagam o método — só mudam se ele está ligado àquele customer. A confirmação e o estado de setup vivem em outro recurso; o payment_method é só a credencial salva.
Data Object
Este é o formato completo retornado emget, update, itens de list,
nas ações attach e detach e em data.object dos webhooks payment.method.*.
Dados não sensíveis do cartão. O número completo e o código de segurança
nunca são retornados.
ID do customer ao qual o método está anexado. Vem
null quando o método não
está ligado a nenhum customer.Data da última atualização em ISO 8601. Vem
null enquanto o método nunca
foi atualizado.Operações
- Listar payment methods
- Consultar payment method
- Atualizar payment method
- Anexar payment method
- Desanexar payment method
Eventos
Mudanças nesse objeto disparam os seguintes eventos: O payload sempre carrega o objetopayment_method completo em data.object; eventos de update também incluem data.previous_attributes com os valores anteriores dos campos alterados.
Como se relaciona
Umsetup_intent valida e salva o cartão
sem cobrar. Quando ele termina em succeeded, o payment_method resultante
pode ser usado em um payment_intent
para cobrar depois.
Setup Intents
Salve um cartão para uso futuro sem realizar cobrança.
Usar em uma cobrança
Envie
customer e payment_method ao criar o Payment Intent.
