logo
APIs
Webhooks
Reference
No results found.
Introduction
Security
Verifying Webhooks
Fulfillment Webhook
get/post
Subscription Created
post
Subscription Updated
post
Subscription Cancelled
post
Subscription Payment Succeeded
post
Subscription Payment Failed
post
Subscription Payment Refunded
post
Locker Processed
post
Payment Succeeded
post
Payment Refunded
post
Payment Dispute Created
post
Payment Dispute Closed
post
High Risk Transaction Created
post
High Risk Transaction Updated
post
Transfer Created
post
Transfer Paid
post
New Audience Member
post
Update Audience Member
post

Fulfillment Webhook

Sent when a one-time purchase order is processed for a product with webhook fulfillment enabled

Fulfillment webhooks can be sent as either a GET or POST request

All fulfillment webhooks include the following data fields:

object
event_time
string

The date and time the event was triggered in UTC (Coordinated Universal Time).

1 validation
p_country
object

The two-letter ISO country code of the customer. Eg: US, GB. See Supported Countries.

p_coupon
string

The coupon code that was used on this order

p_coupon_savings
string

The amount of savings given by the applied coupon.

p_currency
string

The three-letter ISO currency code. Eg: USD, GBP. See Supported Currencies.

p_earnings
string

The amount credited to your balance. It is returned as a JSON string in the format: {"vendor_id": "earnings_amount"}. The string will contain multiple entries if there is more than one account involved in the purchase (for example a split checkout).

1 validation
p_order_id
string

The Paddle Order ID for this payment. This can be used to look up the order within your Seller Dashboard.

p_paddle_fee
string

The amount of this order that was paid to Paddle as a fee.

p_price
string

The price the user paid for this order.

p_product_id
string

The dashboard ID of the product purchased in this order.

1 validation
p_quantity
string

The number of products or subscription seats sold in the transaction.

1 validation
p_sale_gross
string

The total value of the sale (including tax) in the sale currency.

p_tax_amount
string

The amount of this order that was paid in tax.

p_used_price_override
string

Whether the dashboard price was overridden.

1 validation
passthrough
string

This field contains any values that you passed into the checkout using the passthrough parameter. See the Paddle Checkout (Web) documentation for more information.

quantity
string

The number of products or subscription seats sold in the transaction.

1 validation
p_signature
string

This field contains an encrypted token that you can use to verify the request authenticity. See Verifying Webhooks.

Custom Fields

You may specify additional custom webhook data fields for each product, either attaching order-specific information or static values.

The marketing_consent field is only included if the customer email has been included.

{email}
string

The email address of the customer.

format: email
{message}
string

The custom message displayed in the checkout.

{customer_name}
string

The name of the customer (if collected).

{transaction_id}
string

A unique hash representing the transaction.

{checkout_id}
string

The checkout id of the order created.

example: 27835673-chre93c81118fc7-b3092639c1
{static_value}
string

Any fixed string value you wish to include in webhooks for this product.

marketing_consent
string

The value of this field 1 or 0 indicates whether the user has agreed to receive marketing messages from the vendor.

Allowed Values: 0, 1