---
title: transaction.created
description: 계좌에 새 입금이 들어와 기록되면 보내는 이벤트예요.
sidebar:
  order: 8
---

등록한 계좌에 입금이 들어와 페이싱크가 기록하면 보내요. 주문과 매칭하기 전에 보내니, 매칭 결과는 [`invoice.paid`](/api-reference/webhooks/invoice-paid)로 받으세요.

이런 입금에는 보내지 않아요.

- 1원 인증용 입금이에요.
- 요금제의 입금 감지 한도를 넘어 기록하지 않은 입금이에요. [사용량 한도와 초과 사용](/usage-and-overage) 참고

## 입금 페이로드

`data`는 기록한 입금이에요. [API 입금 객체](/api-reference/transactions/get#입금-객체)보다 필드가 적고, 시각은 ISO 8601 문자열이에요.

| 필드 | 타입 | 설명 |
| --- | --- | --- |
| `id` | string | 입금 ID예요. `trx_`로 시작해요. |
| `bankAccount` | object | 입금이 들어온 계좌예요. `id`, `alias`, `provider`, `type`, `number`를 담아요. |
| `depositorName` | string | 은행 알림에 적힌 입금자명이에요. |
| `amount` | integer | 입금 금액(원)이에요. |
| `status` | string | 보낼 때의 입금 상태예요. 매칭 전이라 보통 `UNMATCHED`예요. |
| `matchedInvoiceId` | string \| null | 매칭된 주문 ID예요. 보통 `null`이에요. |
| `matchedInvoiceNumber` | integer \| null | 매칭된 주문번호예요. 보통 `null`이에요. |
| `receivedAt` | string | 은행 알림 기준 입금 시각이에요. |
| `createdAt` | string | 페이싱크가 입금을 기록한 시각이에요. |

```json
{
  "id": "evt_g6h7i8j9k0l1m2n3o4p5q6r7",
  "type": "transaction.created",
  "timestamp": "2026-04-28T03:20:12Z",
  "data": {
    "id": "trx_m1n2o3p4q5r6s7t8u9v0w1x2",
    "bankAccount": {
      "id": "bac_x9y8z7w6v5u4t3s2r1q0p9o8",
      "alias": "대표 계좌",
      "provider": "KB_KOOKMIN_BANK",
      "type": "CORPORATE",
      "number": "123456-01-234567"
    },
    "depositorName": "홍길동",
    "amount": 50000,
    "status": "UNMATCHED",
    "matchedInvoiceId": null,
    "matchedInvoiceNumber": null,
    "receivedAt": "2026-04-28T03:20:00Z",
    "createdAt": "2026-04-28T03:20:12Z"
  }
}
```

## 활용

- 주문과 관계없이 모든 입금을 내 장부에 기록해요.
- 매칭 결과를 기다리지 않고 입금 알림을 바로 띄워요.

매칭되지 않은 입금만 모아 보려면 이 이벤트를 받은 뒤 잠시 기다렸다가 [입금 단건 조회](/api-reference/transactions/get)로 `status`와 `failureReason`을 확인하세요.