# 토스페이먼츠 연동하기 1 - API 연동

이 문서에서는 Hotopay 모듈과 Toss Payments를 연동하는 방법을 설명합니다.

이 글은 Toss Payments에 가맹점으로 가입하여 실제 서비스를 할 수 있다는 가정하에 작성합니다.

### Toss Payments에서 설정

1. <https://app.tosspayments.com/> 에 접속해줍니다
2. `[매출 · 정산 관리]` 항목에 있는 자신의 가맹점위에 마우스를 올려 `[개발 연동]`버튼을 클릭해주세요
3. 테스트 혹은 라이브 항목이 있는데, 테스트를 원한다면 테스트 탭에서, 실 적용시에는 라이브 탭에서 적용해주세요.
4. API 키 항목에서 `[라이브(혹은 테스트) 클라이언트 키]`와  `[라이브(혹은 테스트) 시크릿 키]`를 복사하여 메모장에 적어주세요
5. `[가상계좌 입금 알림 URL]`과 `[Webhook 콜백 URL]`에는 아래 URL을 적어주세요

   `https://{자신의 사이트 URL}/hotopay/api/v1/toss/paymentCallback`
6. 각각 저장하기 버튼을 눌러주세요
7. `"유효한 URL이 아닙니다."` 라는 메세지가 나오더라도 저장하기 버튼을 눌러 넘어가주세요
8. `[응답 버전]`은 `[2022-07-27]` 으로 설정해주세요

여기까지 완료하셨다면 `[클라이언트 키]`와 `[시크릿 키]`가 존재합니다.

### HotoPay 모듈과 연동

1. 사이트 관리자 페이지에 접속해주세요
2. `[설치된 모듈 > Hoto Pay]` 항목에 들어가주세요
3. `[기본 설정]` 탭에 `[Toss Payments 설정]` 항목을 보시면 `[클라이언트 키]`와 `[시크릿 키]` 항목이 존재합니다
4. 클라이언트 키에는 이전에 복사해두었던 `[라이브(혹은 테스트) 클라이언트 키]`를, 시크릿 키에는 `[라이브(혹은 테스트) 시크릿 키]`를 붙여넣어주세요.
   * 클라이언트 키는 "live\_ck" 혹은 "test\_ck" 로 시작합니다
   * 시크릿 키는 "live\_sk" 혹은 "test\_sk"로 시작합니다
5. 토스를 통해 결제할 결제 수단을 선택해주세요.\
   `문화상품권, 휴대폰결제는 토스에서 별도 신청 후 사용이 가능합니다`

**주의, 실 사용시에는 라이브 키로 전부 교체해주시기 바랍니다**

테스트 키로 사용시 결제를 해도 돈이 나가지 않습니다.


---

# Agent Instructions: 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://hotopaydocs.potatosoft.kr/pg/tosspayments.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.