입금 단건 조회

GET /v1/transactions/{id} 로 입금 하나의 상세 정보를 조회해요.

GET /v1/transactions/{id}

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

경로 파라미터

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

요청 예시

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

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();

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())

응답

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

입금 객체

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

`bankAccount` 객체

필드	타입	설명
`id`	string	계좌 ID예요. `bac_`로 시작해요.
`active`	boolean	항상 `true`예요.
`ownerId`	string	워크스페이스 소유자의 계정 ID예요.
`alias`	string	대시보드에서 정한 계좌 별칭이에요.
`provider`	string	은행이에요. `KB_KOOKMIN_BANK`, `NH_NONGHYUP_BANK`, `KEB_HANA_BANK`, `INDUSTRIAL_BANK_OF_KOREA`, `SHINHAN_BANK` 중 하나예요.
`type`	string	`PERSONAL`(개인) 또는 `CORPORATE`(기업)예요.
`number`	string	은행 표기 방식대로 하이픈을 넣은 계좌번호예요.
`createdAt`	string	계좌를 등록한 시각이에요.
`verifiedAt`	string \| null	1원 인증을 마친 시각이에요.
`deletedAt`	null	항상 `null`이에요.

bankAccount는 입금을 받은 시점의 계좌 정보예요. 이후 대시보드에서 별칭을 바꾸거나 계좌 연결을 해제해도 이미 받은 입금의 값은 바뀌지 않아요.

AMOUNT_TOLERANCE로 매칭된 입금은 amount가 주문 금액과 달라요. 차이는 v2 입금 API의 match.amountDiff에서 확인하세요.

오류

HTTP	`code`	발생 조건
401	`NOT_AUTHORIZED`	API 키가 없거나 올바르지 않아요.
403	`INSUFFICIENT_PERMISSIONS`	API 키의 계좌 범위 밖의 계좌로 들어온 입금이에요.
404	`TRANSACTION_NOT_FOUND`	입금이 없어요.

입금 단건 조회

경로 파라미터

요청 예시

응답

입금 객체

bankAccount 객체

오류

`bankAccount` 객체