Paddle Logo
Paddle Classic
Get Started
Guides
API Reference
Webhooks
Reference
Search
Login
Webhook Reference
Webhook Reference
Security
Verifying Webhooks
Order Fulfillment
Fulfillment Webhook
Order Fulfillment
Subscription Alerts
Overview
Subscription Created
Subscription Updated
Subscription Cancelled
Subscription Payment Succeeded
Subscription Payment Failed
Subscription Payment Refunded
One-off Purchase Alerts
Overview
Order Processing Completed
Payment Refunded
Payment Succeeded
Risk & Dispute Alerts
Overview
High Risk Transaction Created
High Risk Transaction Updated
Payment Dispute Created
Payment Dispute Closed
Payout Alerts
Overview
Transfer Created
Transfer Paid
Audience Alerts
Overview
New Audience Member
Update Audience Member
Manual Invoicing Alerts
Overview
Invoice Sent
Invoice Paid
Invoice Overdue
Invoice Cancelled
Manual Invoicing Alerts (Legacy)

Invoice Paid

Summary

An invoice_paid_v2 event is fired when a manual invoice is successfully paid by a customer.

Payload

Information sent in the payload for an invoice_paid_v2 webhook is summarised in the table below.

PropertyTypeDescriptionExample
alert_idstringThe unique identifier for this Paddle webhook alert. Integer value sent as a string.93275
alert_namestringThe alert name.
Default: invoice_paid_v2
countrystringThe two-letter ISO country code of the customer. For a full list of supported countries, see our Supported Countries page.GB
currencystringThe three-letter ISO currency code. For a full list of supported currencies, see our Supported Currencies page.GBP
custom_datastringCustom data sent as key value pairs. JSON array sent as a string.[{"key":"name","value":"Olga"}]
customer_addressstringThe address of the customer for whom this invoice is was issued.1 The Street
customer_citystringThe city the customer is from.London
customer_idstringThe unique identifier for this customer. Integer value sent as a string.2157b874-787d-4342-a7cd-ee55043816b7
customer_namestringThe name of the customer for whom this invoice was issued.John Smith
customer_zipcodestringThe ZIP code of the customer.W1A 1AA
date_issuedstringInvoice issue date. Sent as a string.2022-03-03 15:57:30.912657433 +0000 UTC
days_until_overdueintegerInvoice payment terms in days.12
emailstring<email>The email address of the customer.john.smith@paddle.com
gross_amountintegerGross invoice amount (amount including tax).15000
issued_itemsstringInvoice line items. JSON array sent as a string.[{"product_name":"Book","product_description":"This is a book 2","product_tax_value":"0.2","price":"7000","quantity":"1"},{"product_name":"Keith","product_description":"This is just keith","product_tax_value":"0","price":"4000","quantity":"2"}]
p_signaturestringThis field contains an encrypted token that you can use to verify the request authenticity. See Verifying Webhooks.m+RPbZdEeakYydLhiEogC1Co/SeFM1ot+787i+pOCQe8qn1Lsa46xYzd06QlocM0ceV3HiEd3HDaophkLiFNhNOeLQT0PnBaK7nA6IqxzM2A2HK8ZEJe7fuxctrPCQAgRASUxRB+LenZT/KXmHWkOafnNNnxPAlA22N+6WYnkkKvLksdzoMQPnGMMsYvPoEb7B7BqAi1rreCA9VrXO09o8ofNvrtLMf9ylYpjp86TcCit33tHINsrHnMQXRBE1+R3YusGCJR7XvuXkt4v/YK+KQcFyJukTEnU/3F/jHWJMG+QAX+slbcF+nFXJ1MrM4jU3QA6SPEaKA7O5ORt5/2MhAJkQqqTArFWzFAVDCO+nbzqObMDQWXKx8rGLunL5c8wwGKeUODixmxL6mSHNKtQqvH7PQn5n0DmccOgdms8DpJGF/H7JU0GtpYDKy5Z92l18LPOtuKxz0GpAC15NK6PN+yuRFvQy7OUdn2htxDBeSQ5TiALbdPdaxylF6uExylfV3xuPII7EJSd7A1+FblEh+oq+B75prnTSI3qYbCNi2FvcS8CoUb65Ft1qLgNAKXCKsvlbw/UjqAWX0kQ+z7ENNcKW2CTmvomM/4yh65m8RpIYFmYlRzTsdhu5NXEyYexWnNFdQzUIMAdQRZ/ookILySuxDBKpS98p6CxB7yyzQ=
purchase_order_numberstringCustom order number specified for this invoice.
Max Length: `<=255 characters		123243783219328742
statusstringStatus of the invoice.
Allowed values: paid