transaction.created

계좌에 새 입금이 들어와 기록되면 보내는 이벤트예요.

등록한 계좌에 입금이 들어와 페이싱크가 기록하면 보내요. 주문과 매칭하기 전에 보내니, 매칭 결과는 invoice.paid로 받으세요.

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

1원 인증용 입금이에요.
요금제의 입금 감지 한도를 넘어 기록하지 않은 입금이에요. 사용량 한도와 초과 사용 참고

입금 페이로드

data는 기록한 입금이에요. API 입금 객체보다 필드가 적고, 시각은 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	페이싱크가 입금을 기록한 시각이에요.

{
  "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"
  }
}

활용

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

매칭되지 않은 입금만 모아 보려면 이 이벤트를 받은 뒤 잠시 기다렸다가 입금 단건 조회로 status와 failureReason을 확인하세요.