Update details of an existing payment method. This is useful for updating expiration dates, metadata, or reactivating a soft-deleted payment method.

Key Features

Flexible Updates

Modify metadata or properties of a stored payment method with partial updates.

Reactivation

Reactivate soft-deleted payment methods by setting deleted_at to null.

Multi-Format Support

Supports both card and bank account payment methods.

Usage Notes

Partial Updates: You can update one or multiple fields without affecting others.

Reactivating Payment Methods: To reactivate a payment method, set deleted_at to null.

Validation: Ensure provided values are valid and in the correct format.

Response Structure

Code	Response	Reason
200	Success	Returns the updated payment method object with new details.
400	Bad Request	Invalid input or unmodifiable fields provided.
401	Unauthorized	Authentication failed.
404	Unprocessable Entity	Payment method with the specified ID does not exist.

Important Considerations

Data Integrity: Avoid making changes that could invalidate the payment method.

Customer Notification: Consider notifying customers if their payment method details have changed.

Security: Do not include sensitive information (e.g., full card number) in the update.

❗️
You cannot modify:

card_number

card_cvv

bank_account

bank_routing

nickname (this value is auto generated)

customer_id

TO make these changes, you must create a new payment method. For a new customer_id you would need to create a new customer and payment method.