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

현금영수증 단건 조회

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

GET /v1/cash-receipts/{id}

현금영수증 ID로 현금영수증 하나를 조회해요. v1 API에는 국세청 승인번호를 받은 원본 현금영수증만 보여요. 취소 영수증과 팝빌이 거절한 발급 요청은 대시보드나 v2 API에서 확인하세요. 발급을 요청한 직후에는 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.000+00:00",
    "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 국세청 처리가 끝나 발급됐어요. 이 상태에서만 취소할 수 있어요. 일부만 취소한 현금영수증도 ISSUED예요.
FAILED 국세청 처리에 실패했어요. ntsResultCode로 이유를 확인하세요.
REVOKED 금액 전체를 취소했어요.

오류

HTTP code 발생 조건
401 NOT_AUTHORIZED API 키가 없거나 올바르지 않아요.
404 CASH_RECEIPT_NOT_FOUND 현금영수증이 없어요.

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