Paddle Billing

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. It returns the name that customers entered at checkout when paying by card.


List of payment attempts for this transaction, including successful payments. Sorted by created_at in descending order, so most recent attempts are returned first.


Type of payment method used for this payment attempt.

How it works

Transactions 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, 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 or get a transaction using the API to see the new field. When listing filter to completed transactions using the status parameter with the value completed to return transactions with a successful payment attempt.

Learn more