현금영수증 문서 주소 조회

GET /v2/cash-receipts/{id}/urls 로 현금영수증을 보거나 인쇄하거나 PDF로 받을 수 있는 주소를 받아요.

GET /v2/cash-receipts/{id}/urls

현금영수증 문서를 열 수 있는 팝빌 주소를 받아요. 구매자에게 영수증 화면을 보여 주거나 PDF를 내려받게 할 때 써요.

주소는 팝빌이 그때그때 만드는 임시 주소예요. 저장해 두지 말고 필요할 때마다 새로 받으세요. 국세청 승인번호를 받기 전이거나 발급에 실패한 현금영수증은 주소를 받을 수 없어요.

경로 파라미터

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

요청 예시

curl https://api.paysync.kr/v2/cash-receipts/crt_a1b2c3d4e5f6g7h8i9j0k1l2/urls \
  -H "Authorization: Bearer $PAYSYNC_API_KEY"

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

응답

필드	타입	설명
`view`	string	현금영수증 화면 주소예요.
`print`	string	인쇄용 화면 주소예요.
`pdf`	string	PDF 파일 주소예요.

{
  "code": "10001",
  "data": {
    "view": "https://popbill.linkhub.co.kr/...",
    "print": "https://popbill.linkhub.co.kr/...",
    "pdf": "https://popbill.linkhub.co.kr/..."
  }
}

오류

HTTP	`code`	발생 조건
401	`290006`	API 키가 올바르지 않아요.
404	`20015`	현금영수증이 없어요.
409	`240020`	발급에 실패했거나 국세청 승인번호가 없는 현금영수증이에요.
422	`240001`	현금영수증 ID 형식이 틀렸어요.
502	`240009`	팝빌 호출이 실패했어요. `data`에 팝빌 오류 `code`와 `message`가 와요.