> For the complete documentation index, see [llms.txt](https://developers.payssam.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.payssam.kr/faq/readme.md).

# 자주하는 질문

## 자동결제

<details>

<summary><strong>Q. 구독 서비스는 어떻게 만들어야 하나요?</strong></summary>

구독 서비스는 [청구서 발송 API](/api/api-v2/send.md#post-bill-send) 사용해서 직접 구축해야 합니다.\
1달 주기로 결제가 필요한 상품이면 1달마다 청구서 발송 API를 호출하면 됩니다.

</details>

<details>

<summary><strong>Q. 구독을 취소하면 어떻게 해야 하나요?</strong></summary>

다음 결제일에 구독을 취소한 구매자로 청구서를 발송하지 않으면 됩니다.

</details>

<details>

<summary><strong>Q. 구독 결제 금액이나 결제 주기가 변경되면 어떻게 해야 되나요?</strong></summary>

결제 금액이 변경 되었다면 [청구서 발송 API](/api/api-v2/send.md#post-bill-send) 를 호출할 때 price 파라미터를 변경된 결제 금액으로 설정하면 됩니다.

</details>

***

## 청구서 조회&#x20;

<details>

<summary><strong>Q.청구서는 기간별 조회가 가능한가요?</strong></summary>

현재 API를 통한 청구서 조회는 단건 조회만 가능합니다.\
청구서 기간별 조회가 필요한 경우 [청구서 조회 API](/api/api-v2/acceptance.md#post-bill-read)를 사용하여 직접 구축해야 합니다.

</details>

***

## 개발/테스트 환경

<details>

<summary><strong>Q.테스트 환경에서 결제가 가능한가요?</strong></summary>

네 결제선생은 테스트 환경에서 실제 결제를 지원하고 있습니다.\
다만 일부 특정 카드사의 사정에 따라 결제 테스트가 지원되지 않을 수도 있습니다

결제 가능 카드

* 현대카드, 국민카드, 신한카드

결제 불가능 카드

* 삼성카드, 하나카드

</details>

<details>

<summary><strong>Q. 테스트를 완료 했는데 apikey 발급을 어떻게 받나요?</strong></summary>

테스트가 완료된 경우 연동 검수 단계를 거쳐 운영에서 사용할 수 있는 apikey를 발급받을 수 있게됩니다.

</details>

<details>

<summary><strong>Q. 테스트 환경에서 결제가 잘 됐는데, 라이브 환경에서 이상해요</strong></summary>

1. `apikey`, `member`, `merchant`의 값을 확인해주세요
2. 호출하는 url을 확인해주세요\
   개발 환경과 운영 환경의 도메인(url)은 다른 url 이에요

</details>

***

## 웹훅(CallBack)

<details>

<summary><strong>Q. 웹훅 이벤트가 도착하지 않아요</strong></summary>

웹훅 URL을 정확하게 입력했는지 다시 한번 확인해주세요

청구서 발송은 매번 새로운 웹훅을 파라미터로 받고 있어요 정확하게 url을 입력했는지 확인해주세요

</details>

<details>

<summary><strong>Q. 웹훅을 어떨 때 받을 수 있나요?</strong></summary>

[웹훅](/api/api-v2/sub-business.md#post-callbackurl)은 청구서 결제 완료, 청구서 취소, 하위 사업장 등록 처리가 되었을 때 보내고 있습니다

</details>

***

## 포인트

<details>

<summary><strong>Q. 쌤포인트가 부족하다고 나와요</strong></summary>

포인트 잔액을 확인해주세요\
자세한 내용은 [링크](#undefined-7)를 참조해주세요

</details>

<details>

<summary><strong>Q. 쌤포인트는 자동충전할 수 없나요?</strong></summary>

쌤포인트는 자동 충전이 가능합니다\
자세한 내용은 링크를 참조해주세요

</details>

***

### API 버전

<details>

<summary><strong>Q. 기존에 파트너 계약을 맺고 있는데 V2 API 호출하려면 API KEY를 새로 발급 받아야하나요?</strong></summary>

기존 파트너 계약을 맺고 있는 파트너 사업자는 V1에서 사용하던 API KEY로 V2 API를 사용할 수 있습니다.

</details>

<details>

<summary><strong>Q. V2 버전에서도 청구서 URL 이용  가능한가요?</strong> </summary>

청구서 발송의 sendType이 URL인 경우 이용 가능합니다.\
자세한 내용은 [링크](/api/api-v2/send.md#post-bill)를 참조해주세요

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.payssam.kr/faq/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.