---
title: invoice.updated
description: 결제 대기 주문의 입금자명, 금액, 입금 기한, 받을 계좌, 현금영수증 정보가 바뀌면 보내는 이벤트예요.
sidebar:
  order: 4
---

결제 대기 주문의 내용이 바뀌면 보내요. 대시보드 **주문**에서 수정했거나 [주문 수정](/api-reference/invoices/update) API를 호출했을 때 와요.

결제 완료, 만료, 취소처럼 상태가 바뀔 때는 이 이벤트 대신 상태별 이벤트가 가요.

## 페이로드

`data`는 바뀐 뒤의 [주문 페이로드](/api-reference/webhooks/overview#주문-페이로드)예요. 무엇이 바뀌었는지는 담지 않아요. 바뀐 필드가 필요하면 [주문 단건 조회](/api-reference/invoices/get)의 `history`에서 `UPDATED` 항목의 `changes`를 확인하세요.

```json
{
  "id": "evt_b1c2d3e4f5g6h7i8j9k0l1m2",
  "type": "invoice.updated",
  "timestamp": "2026-04-28T05:00:00Z",
  "data": {
    "id": "ivc_a1b2c3d4e5f6g7h8i9j0k1l2",
    "number": 1043,
    "status": "PENDING",
    "customer": {
      "name": "홍길동",
      "email": "hong@example.com",
      "phoneNumber": "01012345678"
    },
    "amount": 48000,
    "paidAmount": null,
    "amountDiff": null,
    "bankAccountIds": [],
    "cashReceipt": null,
    "metadata": { "orderId": "ORDER-2026-0001" },
    "source": "API",
    "createdAt": "2026-04-28T03:14:15Z",
    "updatedAt": "2026-04-28T05:00:00Z",
    "expiresAt": "2026-05-02T03:14:15Z",
    "paidAt": null,
    "paidTrigger": null,
    "matchedTransactionId": null,
    "canceledAt": null,
    "cancelReason": null,
    "expiredAt": null,
    "reopenedAt": null
  }
}
```

## 처리 예시

금액이나 입금 기한이 바뀌었을 수 있으니 내 시스템의 주문과 고객 화면을 맞춰요.

```js Node.js
if (event.type === "invoice.updated") {
  const invoice = event.data;
  await db.orders.updateByInvoiceId(invoice.id, {
    amount: invoice.amount,
    customerName: invoice.customer.name,
    expiresAt: invoice.expiresAt ? new Date(invoice.expiresAt) : null,
  });
}
```