PaymentMethod

​

Campos

​

PaymentMethodCard

​

Armazenamento

​

Relacionamentos

• Relaciona-se com Customer.

​

Regras de Negócio

• PaymentMethod pertence a um Customer, não diretamente ao User.
• A criação de cartão recebe um cardToken gerado no cliente.
• O número do cartão nunca trafega nem é armazenado pelo DEVMOB.
• externalProviderId é obrigatório para cartões salvos no gateway.
• PIX e CASH podem existir sem externalProviderId, pois representam opções habilitadas ou preferidas para o customer.
• O campo card só deve ser preenchido para CREDIT_CARD ou DEBIT_CARD.
• Métodos de pagamento externos são acessados pelo contrato genérico de Billing Provider.

​

Enums

​

PaymentMethodType

​

Example

{
  "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,
  "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "createdAt": "2026-07-03T15:50:00.000Z",
  "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
  "updatedAt": "2026-07-03T15:50:00.000Z"
}