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.
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.
Summary of changes
| Entity | Field | Change | Type |
|---|---|---|---|
| Transaction | cardholder_name | + Added | Field |
| On payments[].method_details.card. | |||