payment_method.updated

{ "event": "payment_method.updated", "timestamp": "2026-06-23T14:30:00.000Z", "organizationId": "8f14e45f-ceea-4e7a-9c3d-1c2b3a4d5e6f", "mode": "live", "apiVersion": "2026-08-27", "data": { "customerId": "user_123", "paymentMethod": "mercado_pago", "card": null } }

When this fires

Fired when a customer replaces their default payment method through the customer portal. The new method applies to all of the customer’s subscriptions.

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

paymentMethod identifies the newly saved instrument (card or mercado_pago; OXXO never leaves a saved instrument). It does not describe which method paid an earlier transaction.

Use it to refresh the card shown in your billing UI. A payment method update is also a strong recovery signal for past-due subscriptions — the customer typically updates their card to fix a failed payment.

Body

application/json

string

required

event

string

required

Allowed value: "payment_method.updated"

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.updated

When this fires

Body

Response

​When this fires

Body

Response

When this fires