payment_method.created - Documentação DEVMOB

payment_method.created é emitido depois que um PaymentMethod é criado no provider de billing para um Customer. Handlers usam este evento para executar efeitos assíncronos fora do fluxo síncrono, como auditoria e futuras integrações de segurança.

Detalhes do Evento

Propriedade	Valor
Tipo	`payment_method.created`
Origem	Criação de PaymentMethod
Publicação	Após criação confirmada pelo provider
Quando	Customer salva um cartão tokenizado pelo endpoint de PaymentMethod.

Payload

Campo	Tipo	Descrição
`identifier`	`UUID`	Chave de idempotência do evento
`data`	`PaymentMethod`	Entidade PaymentMethod criada

Regras dos handlers

Handlers não rodam na operação síncrona do provider.
Falha em handler não desfaz o método criado no provider.
Cada handler deve ser idempotente.
Novos handlers podem ser adicionados sem mudar o fluxo síncrono.

Exemplo

{
  "type": "payment_method.created",
  "identifier": "0197a816-aec9-71f9-801f-9ce13ff707ae",
  "data": {
    "paymentMethodId": "0197a816-aec9-71f9-801f-9ce13ff707ae",
    "customerId": "0197a7f6-4d36-7c0a-a7cb-54fcb33a3148",
    "externalProvider": "billing_interface",
    "externalProviderId": "pm_7df4a219",
    "type": "CREDIT_CARD",
    "card": {
      "brand": "VISA",
      "last4": "4242"
    },
    "isDefault": true
  }
}