Revise customer details for a transaction after purchase
Add a tax or VAT number, supplement address information, and update customer and business names on PDFs sent for completed transactions.
What's new?
We've added a new operation to the Paddle API that you can use to revise customer, address, and business information for completed and billed transactions.
Paddle ID of the transaction that you want to revise customer, address, and business information for.
How it works
Billed and completed transactions are financial records, so they can't be deleted or changed. However, it's common for customers to want to update their details after they've completed a checkout, or after you've issued an invoice. For example, they might want to add a tax number or fill out their address.
Use the new revise a transaction operation to update customer, address, and business information for a completed or billed transaction. Customers receive an updated PDF invoice with the revised information on it. If you add a valid tax number, Paddle creates an adjustment to refund any tax where applicable.
The existing transaction entity remains on your system unchanged for recordkeeping purposes.
When you revise a transaction, you're only updating the customer, address, and business information for that particular transaction. The related customer, address, and business entities aren't updated.
To learn more, see: Revise customer details on a billed or completed transaction
Summary of changes
Fields
This is a summary of the changes to fields in the Paddle API and webhooks:
| Field | Change | Notes |
|---|---|---|
transaction.revised_at | New field | RFC 3339 datetime string of when a transaction was revised. null if not revised. |
API operations
This is a summary of new operations in the Paddle API:
| Method | Path | Summary |
|---|---|---|
GET | transactions/{transaction_id}/revise | Revise customer information on a billed or completed transaction |
Webhooks
This is a summary of new webhooks:
| Event | Description |
|---|---|
transaction.revised | Occurs when customer information for a billed or completed transaction is revised. |
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.
Use the revise customer information on a billed or completed transaction operation to update customer information for a completed or billed transaction.
