---
title: 현금영수증 문서 주소 조회
description: GET /v2/cash-receipts/{id}/urls 로 현금영수증을 보거나 인쇄하거나 PDF로 받을 수 있는 주소를 받아요.
sidebar:
  order: 6
  badge: GET
---

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

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

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

## 경로 파라미터

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

## 요청 예시

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

```js Node.js
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();
```

```python Python
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 파일 주소예요. |

```json 200 OK
{
  "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`가 와요. |