payment_method.attached

{ "event": "payment_method.attached", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "subscriptionId": "sub_1a2b3c4d", "customerId": "user_123", "paymentMethod": "card", "card": { "brand": "visa", "last4": "4242", "expMonth": 12, "expYear": 2030 } } }

When this fires

Fired when Commet records a payment method for a subscription: after a paid checkout, when a trial starts with a card on file, or when a zero-total checkout completes with a saved payment method.

The card object carries display metadata only — brand, last 4 digits, and expiration. Full card numbers never leave the payment provider. When the saved method is not a card or its details cannot be retrieved, card is null.

paymentMethod identifies the saved instrument (card or mercado_pago; OXXO never leaves a saved instrument). A null card object does not identify its type.

Use it to show the saved card in your own billing UI or confirm to the customer that their payment method is on file.

Body

application/json

string

required

event

string

required

Allowed value: "payment_method.attached"

timestamp

string

required

organizationId

string

required

mode

enum<string>

required

Available options:

live,

sandbox

apiVersion

string

required

data

object

required

Show child attributes

Response

200

Return any 2xx status code to acknowledge receipt of the event.

Overview

Events

payment_method.attached

When this fires

Body

Response

​When this fires

Body

Response

When this fires