본문으로 건너뛰기
페이싱크 개발자센터
Esc
↑↓이동↵열기⌘J미리보기
이 페이지에서

현금영수증 단건 조회

GET /v1/cash-receipts/{id} 로 현금영수증 하나의 발급 상태와 상세 정보를 조회해요.

GET /v1/cash-receipts/{id}

현금영수증 ID로 현금영수증 하나를 조회해요. 발급을 요청한 직후에는 status가 PENDING이에요. 국세청 처리에는 시간이 걸리니 짧은 간격으로 계속 조회하지 말고, 시간을 두고 확인하세요.

경로 파라미터

파라미터 타입 설명
id string 조회할 현금영수증 ID예요. crt_로 시작해요.

요청 예시

curl https://api.paysync.kr/v1/cash-receipts/crt_a1b2c3d4e5f6g7h8i9j0k1l2 \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"
const res = await fetch(`https://api.paysync.kr/v1/cash-receipts/${cashReceiptId}`, {
  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/cash-receipts/{cash_receipt_id}",
    headers={"Authorization": f"Bearer {os.environ['PAYSYNC_API_KEY']}"},
)
print(res.json())

응답

{
  "code": "OK",
  "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
  }
}

현금영수증 객체

필드 타입 설명
id string 현금영수증 ID예요. crt_로 시작해요.
status string 발급 상태예요. 아래 표를 참고하세요.
issuerId string 발급한 페이싱크 계정 ID예요.
corpNum string 발급한 사업자의 사업자등록번호예요.
type string PERSONAL(소득공제용) 또는 CORPORATE(지출증빙용)예요.
identifier string 휴대폰 번호나 사업자등록번호예요.
amount integer 거래 금액(원)이에요.
relatedInvoiceId string | null 주문 결제 완료로 자동 발급됐다면 그 주문 ID예요.
ntsConfirmNum string 국세청 승인번호예요. 발급을 요청할 때 받아요.
ntsResultCode string | null 국세청 처리 결과 코드예요. 결과가 오기 전에는 null이에요.
issuedAt string 발급을 요청한 시각이에요.
revokedAt string | null 발급을 취소한 시각이에요.
deletedAt null 조회할 수 있는 현금영수증에서는 null이에요.
status 뜻
PENDING 국세청 처리를 기다리고 있어요. 이 상태에서만 취소할 수 있어요.
ISSUED 국세청 처리가 끝나 발급됐어요.
FAILED 국세청 처리에 실패했어요. ntsResultCode로 이유를 확인하세요.
REVOKED 발급을 취소했어요.

오류

HTTP code 발생 조건
401 NOT_AUTHORIZED API 키가 없거나 올바르지 않아요.
403 INSUFFICIENT_PERMISSIONS 다른 계정의 현금영수증이에요.
404 CASH_RECEIPT_NOT_FOUND 현금영수증이 없어요.

이 페이지가 도움이 되었나요?