Skip to content
Paddle Classic
You're viewing guides for Paddle Classic, which is no longer available for new signups. Head to developer.paddle.com for Paddle Billing guides.

Invoice paid

Summary

Section titled “Summary”

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

Payload

Section titled “Payload”

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

Property Type Description Example
alert_id string The unique identifier for this Paddle webhook alert. Integer value sent as a string. 93275
alert_name string The alert name.
Default: invoice_paid_v2
country string The two-letter ISO country code of the customer. For a full list of supported countries, see our Supported Countries page. GB
currency string The three-letter ISO currency code. For a full list of supported currencies, see our Supported Currencies page. GBP
custom_data string Custom data sent as key value pairs. JSON array sent as a string. [{"key":"name","value":"Olga"}]
customer_address string The address of the customer for whom this invoice is was issued. 1 The Street
customer_city string The city the customer is from. London
customer_id string The unique identifier for this customer. Integer value sent as a string. 2157b874-787d-4342-a7cd-ee55043816b7
customer_name string The name of the customer for whom this invoice was issued. John Smith
customer_zipcode string The ZIP code of the customer. W1A 1AA
date_issued string Invoice issue date. Sent as a string. 2022-03-03 15:57:30.912657433 +0000 UTC
days_until_overdue integer Invoice payment terms in days. 12
email string<email> The email address of the customer. john.smith@paddle.com
gross_amount integer Gross invoice amount (amount including tax). 15000
issued_items string Invoice 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_signature string This 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_number string Custom order number specified for this invoice.
Max Length: `<=255 characters		 123243783219328742
status string Status of the invoice.
Allowed values: paid