---
title: 입금 단건 조회
description: GET /v1/transactions/{id} 로 입금 하나의 상세 정보를 조회해요.
sidebar:
  order: 2
  badge: GET
---

```http
GET /v1/transactions/{id}
```

입금 ID로 입금 하나를 조회해요. 입금 계좌, 입금자명, 매칭된 주문과 매칭 방식을 확인할 수 있어요.

## 경로 파라미터

| 파라미터 | 타입 | 설명 |
| --- | --- | --- |
| `id` | string | 조회할 입금 ID예요. `trx_`로 시작해요. |

## 요청 예시

```bash cURL
curl https://api.paysync.kr/v1/transactions/trx_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"
```

```js Node.js
const res = await fetch(`https://api.paysync.kr/v1/transactions/${transactionId}`, {
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { code, data } = await res.json();
```

```python Python
import os
import requests

res = requests.get(
    f"https://api.paysync.kr/v1/transactions/{transaction_id}",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
)
print(res.json())
```

## 응답

```json 200 OK
{
  "code": "OK",
  "data": {
    "id": "trx_a1b2c3d4e5f6g7h8i9j0k1l2",
    "bankAccount": {
      "id": "bac_x9y8z7w6v5u4t3s2r1q0p9o8",
      "active": true,
      "ownerId": "acc_x9y8z7w6v5u4t3s2r1q0p9o8",
      "alias": "사업용 계좌",
      "provider": "KB_KOOKMIN_BANK",
      "type": "PERSONAL",
      "number": "12345678901234",
      "createdAt": "2026-04-01T02:00:00.000Z",
      "verifiedAt": "2026-04-01T02:05:00.000Z",
      "deletedAt": null
    },
    "matchedInvoiceId": "ivc_n0o1p2q3r4s5t6u7v8w9x0y1",
    "matchMethod": "EXACT",
    "amount": 50000,
    "description": "홍길동",
    "hidden": false,
    "receivedAt": "2026-04-28T03:20:11.000Z",
    "matchedAt": "2026-04-28T03:20:12.412Z",
    "createdAt": "2026-04-28T03:20:12.000Z",
    "deletedAt": null
  }
}
```

### 입금 객체

| 필드 | 타입 | 설명 |
| --- | --- | --- |
| `id` | string | 입금 ID예요. `trx_`로 시작해요. |
| `bankAccount` | object | 입금이 들어온 계좌예요. 아래 표를 참고하세요. |
| `matchedInvoiceId` | string \| null | 매칭된 주문 ID예요. 매칭되지 않았으면 `null`이에요. |
| `matchMethod` | string \| null | 매칭 방식이에요. `EXACT`, `BRACKET_REMOVAL`, `NAME_PREFIX`, `MANUAL` 중 하나예요. [매칭 어시스트](/matching-assist#매칭-방식-확인) 참고 |
| `amount` | integer | 입금 금액(원)이에요. |
| `description` | string | 은행 알림에 적힌 입금자명이에요. |
| `hidden` | boolean | 대시보드에서 숨긴 입금인지 여부예요. API로는 바꿀 수 없어요. |
| `receivedAt` | string | 은행 알림 기준 입금 시각이에요. |
| `matchedAt` | string \| null | 주문에 매칭된 시각이에요. |
| `createdAt` | string | 페이싱크가 입금 알림을 받은 시각이에요. |
| `deletedAt` | null | 조회할 수 있는 입금에서는 `null`이에요. |

### `bankAccount` 객체

| 필드 | 타입 | 설명 |
| --- | --- | --- |
| `id` | string | 계좌 ID예요. `bac_`로 시작해요. |
| `active` | boolean | 계좌 사용 여부예요. |
| `ownerId` | string | 계좌를 등록한 페이싱크 계정 ID예요. |
| `alias` | string | 대시보드에서 정한 계좌 별칭이에요. |
| `provider` | string | 은행이에요. `KB_KOOKMIN_BANK`, `NH_NONGHYUP_BANK`, `KEB_HANA_BANK`, `INDUSTRIAL_BANK_OF_KOREA`, `SHINHAN_BANK`, `IM_BANK`, `K_BANK` 중 하나예요. |
| `type` | string | `PERSONAL`(개인) 또는 `CORPORATE`(기업)예요. |
| `number` | string | 하이픈 없는 계좌번호예요. |
| `createdAt` | string | 계좌를 등록한 시각이에요. |
| `verifiedAt` | string \| null | 1원 인증을 마친 시각이에요. |
| `deletedAt` | null | 삭제되지 않은 계좌에서는 `null`이에요. |

`bankAccount`는 입금을 받은 시점의 계좌 정보예요. 이후 대시보드에서 별칭을 바꿔도 이미 받은 입금의 값은 바뀌지 않아요.

## 오류

| HTTP | `code` | 발생 조건 |
| --- | --- | --- |
| 401 | `NOT_AUTHORIZED` | API 키가 없거나 올바르지 않아요. |
| 403 | `INSUFFICIENT_PERMISSIONS` | 다른 계정의 입금이거나, [API 키의 접근 가능한 계좌](/api-reference#api-키-계좌-제한) 밖의 계좌로 들어온 입금이에요. |
| 404 | `TRANSACTION_NOT_FOUND` | 입금이 없어요. |