> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Get the cardholder name used for transaction payments

Cardholder name is now included in transaction notifications and responses from the Paddle API, letting you display this information in your frontend.

---

## What's new?

We added a new `cardholder_name` field to `payments[].method_details.card` against a [transaction entity](https://developer.paddle.com/api-reference/transactions/overview.md). It returns the name that customers entered at checkout when [paying by card](https://developer.paddle.com/concepts/payment-methods/credit-debit-card.md).

- **payments** (array): List of payment attempts for this transaction, including successful payments. Sorted by `created_at` in descending order, so most recent attempts are returned first.

## How it works

[Transactions](https://developer.paddle.com/api-reference/transactions/overview.md) have an array of `payments`, which returns an object for each payment attempt for a transaction. When a payment attempt is made by card, Paddle returns a `card` object in `method_details` that includes information about the card used to pay. It includes the card type, last four digits, expiry month, and expiry year.

We added `cardholder_name` to the `card` object, so now you can get the name of the cardholder for a payment.

This is especially useful for billing information screens and [payment change workflows](https://developer.paddle.com/build/subscriptions/update-payment-details.md), where you might like to show a customer information about their existing payment method.

## Next steps

This change is available in version `1` of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can [list transactions](https://developer.paddle.com/api-reference/transactions/list-transactions.md) or [get a transaction](https://developer.paddle.com/api-reference/transactions/get-transaction.md) using the API to see the new field. When listing [filter to completed transactions](https://developer.paddle.com/api-reference/about/filter-search-sort.md) using the `status` parameter with the value `completed` to return transactions with a successful payment attempt.
## Summary of changes

| Name | Type | Change | Entity | Description |
| --- | --- | --- | --- | --- |
| `cardholder_name` | Field | added | Transaction | On payments[].method_details.card. |