현금영수증 목록 조회

GET /v1/cash-receipts 로 내 계정의 현금영수증 발급 내역을 페이지 단위로 조회해요.

GET /v1/cash-receipts

API 키 계정의 현금영수증을 최신순으로 조회해요. 상태, 종류, 식별번호, 발급 날짜로 거를 수 있어요.

쿼리 파라미터

요청 예시

curl "https://api.paysync.kr/v1/cash-receipts?offset=0&limit=20&status=ISSUED" \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"

const params = new URLSearchParams({ offset: "0", limit: "20", status: "ISSUED" });
const res = await fetch(`https://api.paysync.kr/v1/cash-receipts?${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/cash-receipts",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
    params={"offset": 0, "limit": 20, "status": "ISSUED"},
)
print(res.json())

응답

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

{
  "code": "OK",
  "totalItems": 1,
  "data": [
    {
      "id": "crt_a1b2c3d4e5f6g7h8i9j0k1l2",
      "status": "ISSUED",
      "issuerId": "acc_x9y8z7w6v5u4t3s2r1q0p9o8",
      "corpNum": "1234567890",
      "type": "PERSONAL",
      "identifier": "01012345678",
      "amount": 50000,
      "relatedInvoiceId": "ivc_n0o1p2q3r4s5t6u7v8w9x0y1",
      "ntsConfirmNum": "TB0000123",
      "ntsResultCode": "0000",
      "issuedAt": "2026-04-28T03:20:13.000Z",
      "revokedAt": null,
      "deletedAt": null
    }
  ]
}

오류