Skip to main content
WEBHOOK
adjustment.updated
{
  "event_id": "evt_01hvgfdfepj8eaevsjh5g4swbe",
  "event_type": "adjustment.updated",
  "occurred_at": "2024-04-15T08:54:10.646377Z",
  "notification_id": "ntf_01hvgfdfhwncqrrjz1nz5eky9a",
  "data": {
    "id": "adj_01hvgf2s84dr6reszzg29zbvcm",
    "items": [
      {
        "id": "adjitm_01hvgf2s84dr6reszzg2gx70gj",
        "type": "partial",
        "amount": "100",
        "totals": {
          "tax": "8",
          "total": "100",
          "subtotal": "92"
        },
        "item_id": "txnitm_01hvcc94b7qgz60qmrqmbm19zw",
        "proration": null
      }
    ],
    "action": "refund",
    "type": "partial",
    "reason": "error",
    "status": "pending_approval",
    "totals": {
      "fee": "5",
      "tax": "8",
      "total": "100",
      "earnings": "87",
      "subtotal": "92",
      "currency_code": "USD"
    },
    "created_at": "2024-04-15T08:48:20.239695Z",
    "updated_at": "2024-04-15T08:54:10.646377Z",
    "customer_id": "ctm_01hv6y1jedq4p1n0yqn5ba3ky4",
    "currency_code": "USD",
    "payout_totals": {
      "fee": "5",
      "tax": "8",
      "total": "100",
      "earnings": "87",
      "subtotal": "92",
      "currency_code": "USD"
    },
    "transaction_id": "txn_01hvcc93znj3mpqt1tenkjb04y",
    "subscription_id": "sub_01hvccbx32q2gb40sqx7n42430",
    "credit_applied_to_balance": null
  }
}

Headers

​
Paddle-Signature
string
required

Signature for this request. Use to verify that webhooks come from Paddle.

Example:

"ts=1671552777;h1=eb4d0dc8853be92b7f063b9f3ba5233eb920a09459b6e6b2c26705b4364db151"

Body

application/json

Occurs when an adjustment is updated.

This only occurs for refund adjustments, which must be approved by Paddle and are created as pending_approval initially. On review, they move to approved or rejected and adjustment.updated occurs.

​
data
Adjustment Notification · object

Response

200

Respond with an HTTP 200 status code within 5 seconds to let Paddle know that you successfully received the message.

If your server sends another kind of status code or doesn't respond, Paddle automatically retries using an exponential backoff schedule.