입금 내역 목록 조회

GET /v1/transactions 로 내 계좌에 들어온 입금을 페이지 단위로 조회해요.

GET /v1/transactions

API 키 계정의 계좌에 들어온 입금을 최신순으로 조회해요. 계좌, 매칭 여부, 받은 날짜로 거를 수 있어요. 계좌를 제한한 API 키로는 허용된 계좌의 입금만 나와요.

새 입금을 바로 처리해야 한다면 폴링보다 invoice.paid 웹훅을 쓰세요. 이 API는 정산, 대사, 매칭되지 않은 입금 확인에 어울려요.

쿼리 파라미터

날짜 필터와 정렬은 페이싱크가 입금 알림을 받은 시각(createdAt) 기준이에요.

주문 하나에 매칭된 입금을 찾으려면 search에 주문 ID(ivc_...)를 넣으세요.

요청 예시

curl "https://api.paysync.kr/v1/transactions?offset=0&limit=20&matched=false" \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"

const params = new URLSearchParams({ offset: "0", limit: "20", matched: "false" });
const res = await fetch(`https://api.paysync.kr/v1/transactions?${params}`, {
  headers: { Authorization: `Bearer ${process.env.PAYSYNC_API_KEY}` },
});
const { totalItems, data } = await res.json();

import os
import requests

res = requests.get(
    "https://api.paysync.kr/v1/transactions",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
    params={"offset": 0, "limit": 20, "matched": "false"},
)
print(res.json())

응답

data는 입금 객체 배열이고, totalItems는 조건에 맞는 전체 입금 수예요.

{
  "code": "OK",
  "totalItems": 3,
  "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": null,
      "matchMethod": null,
      "amount": 30000,
      "description": "김철수",
      "hidden": false,
      "receivedAt": "2026-04-28T05:02:40.000Z",
      "matchedAt": null,
      "createdAt": "2026-04-28T05:02:41.000Z",
      "deletedAt": null
    }
  ]
}

오류