# 토스페이먼츠 설정
{% hint style="warning" %}
**Deprecated**
이 문서는 더 이상 관리되지 않습니다.
[PortOne 개발자센터](https://developers.portone.io/)를 이용해주세요.
{% endhint %}
{% hint style="info" %}
**토스페이먼츠 신 모듈 연동 안내**
포트원 토스페이먼츠 연동은 토스페이먼츠의 API 버전에 따라 **신 모듈(2022-07-27) / 구 모듈(1.4)** 연동 방식을 제공하고 있습니다. 연동하는 가맹점 입장에서는 구 모듈과 신 모듈의 서비스 차이점은 존재하지 않으나, **원활한 기술 지원 및 더 나은 연동 경험**을 위해 **신 모듈로 연동**하시는 것을 권장드립니다.
{% endhint %}
## 인증결제 (신 모듈)
{% tabs %}
{% tab title="토스페이먼츠 API 버전 설정" %}
**토스페이먼츠 API 버전 설정**
* [토스페이먼츠 개발자센터](https://app.tosspayments.com/signin?redirectUrl=https%3A%2F%2Fdevelopers.tosspayments.com%2Fmy%2Fapi-keys) 로그인
* 왼쪽 네비게이션 메뉴 API 키 선택 → API 버전을 **2022-07-27**로 선택
{% hint style="warning" %}
API 버전을 다르게 설정하면 결제 승인 / 실패 시 실제 응답과 다른 응답을 받아볼 수 있으니 반드시 API 버전을 **2022-07-27**로 맞춰주시기 바랍니다
{% endhint %}
{% endtab %}
{% tab title="테스트 결제" %}
**테스트 환경 구성 방법**
1. [포트원 관리자 콘솔 로그인](https://admin.portone.io/integration)
2. **결제 연동** → **테스트 연동 관리** 탭
3. 결제 대행사 설정에서 토스페이먼츠 / 토스페이먼츠 선택 후 오른쪽 `+ 추가` 버튼 클릭
4. 테스트 연동 정보 확인 후 오른쪽 하단 `저장` 버튼 클릭
5. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 `tosspayments.PG상점아이디`를 입력
* 토스에서 직접 계약 후 발급받은 상점아이디의 테스트 API 키로 진행해주세요.\
토스페이먼츠 개발자센터의 공용 테스트 API 키를 사용하시면 에러가 발생합니다.
{% endtab %}
{% tab title="실 결제" %}
**실 환경 구성 방법**
1. [포트원 관리자 콘솔 로그인](https://admin.portone.io/integration)
2. **결제 연동** → **실 연동 관리** 탭
3. 결제 대행사 설정에서 토스페이먼츠 / 토스페이먼츠 선택 후 오른쪽 `+ 추가` 버튼 클릭\\
4. 테스트 연동 정보 확인 후 오른쪽 하단 `저장` 버튼 클릭\\
5. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 `tosspayments.실연동상점아이디`를 입력
{% endtab %}
{% endtabs %}
## 인증**결제 (구 모듈)**
{% tabs %}
{% tab title="테스트 결제" %}
**테스트 환경 구성방법**
1. \[포트원관리자콘솔]\() **-> 결제연동 -> 테스트 연동관리 -> 토스페이먼츠 -> (구)토스페이먼츠->추가**
2. **자동으로 설정된 테스트 MID 확인후 저장 선**
{% endtab %}
{% tab title="실 결제" %}
**실 환경 구성방법**
1. **결제연동** -> **실 연동관리** 선택
2. **토스페이먼츠** -> **(구) 토스페이먼츠** 선택 -> **추가**
3. 토스페이먼츠와 계약 후 발급된 연동상점정보(MID/ MertKey)를 기재합니다.
{% hint style="danger" %}
발급 MID 방식
포트원을 통한 토스페이먼츠 인증결제를 위해서는 토스페이먼츠 인증결제 MID 발급 요청시 반드시 **구 인증 모듈 방식**이라고 언급해주셔야 올바른 값을 부여받을 수 있습니다.
{% endhint %}
{% endtab %}
{% endtabs %}