Invoice Paid

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

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