# 토스페이먼츠 설정

{% 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 %}

<figure><img src="/files/XQ1s6ZR4pNrnzUwiErId" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="테스트 결제" %}
**테스트 환경 구성 방법**

1. [포트원 관리자 콘솔 로그인](https://admin.portone.io/integration)
2. **결제 연동** → **테스트 연동 관리** 탭
3. 결제 대행사 설정에서 토스페이먼츠 / 토스페이먼츠 선택 후 오른쪽 `+ 추가` 버튼 클릭

   <figure><img src="/files/S61I7ZWsbd8ehwuvqJ1Y" alt=""><figcaption></figcaption></figure>
4. 테스트 연동 정보 확인 후 오른쪽 하단 `저장` 버튼 클릭

<figure><img src="/files/gABqvg56jBwLYH9XohWe" alt=""><figcaption></figcaption></figure>

5. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 `tosspayments.PG상점아이디`를 입력
   * 토스에서 직접 계약 후 발급받은 상점아이디의 테스트 API 키로 진행해주세요.\
     토스페이먼츠 개발자센터의 공용 테스트 API 키를 사용하시면 에러가 발생합니다.
     {% endtab %}

{% tab title="실 결제" %}
**실 환경 구성 방법**

1. [포트원 관리자 콘솔 로그인](https://admin.portone.io/integration)
2. **결제 연동** → **실 연동 관리** 탭
3. 결제 대행사 설정에서 토스페이먼츠 / 토스페이먼츠 선택 후 오른쪽 `+ 추가` 버튼 클릭\\

   <figure><img src="/files/GMJ1QmUT2JdquihoJyTN" alt=""><figcaption></figcaption></figure>
4. 테스트 연동 정보 확인 후 오른쪽 하단 `저장` 버튼 클릭\\

   <figure><img src="/files/RiK69Hw1a9VPa7ys4xvR" alt=""><figcaption></figcaption></figure>
5. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 `tosspayments.실연동상점아이디`를 입력
   {% endtab %}
   {% endtabs %}

## 인증**결제 (구 모듈)**

{% tabs %}
{% tab title="테스트 결제" %}
**테스트 환경 구성방법**

1. \[포트원관리자콘솔]\(<https://admin.portone.io>) **-> 결제연동 -> 테스트 연동관리 -> 토스페이먼츠 -> (구)토스페이먼츠->추가**
2. **자동으로 설정된 테스트 MID 확인후 저장 선**

![결제연동 -> 테스트 연동관리 -> 토스페이먼츠 -> (구)토스페이먼츠 ->추가](/files/3Rix5qK6TZFFGeIkSI8B)

![자동으로 설정된 테스트 MID 확인후 저장](/files/Tzb5MYh3C23wne101x26)
{% endtab %}

{% tab title="실 결제" %}
**실 환경 구성방법**

1. **결제연동** -> **실 연동관리** 선택
2. **토스페이먼츠** -> <mark style="color:red;">**(구) 토스페이먼츠**</mark> 선택 -> **추가**
3. 토스페이먼츠와 계약 후 발급된 연동상점정보(MID/ MertKey)를 기재합니다.

{% hint style="danger" %}
발급 MID 방식

포트원을 통한 토스페이먼츠 인증결제를 위해서는 토스페이먼츠 인증결제 MID 발급 요청시 반드시 <mark style="color:red;">**구 인증 모듈 방식**</mark>이라고 언급해주셔야 올바른 값을 부여받을 수 있습니다.
{% endhint %}

![결제연동 -> 실 연동관리 선택](/files/5hoeba1R1QZ62c9HtAmh)

<figure><img src="/files/qhgZgZp1IQbKYU32offM" alt=""><figcaption><p><strong>토스페이먼츠</strong> -> <mark style="color:red;"><strong>(구) 토스페이먼츠</strong></mark> 선택 -> <strong>추가</strong></p></figcaption></figure>

<img src="/files/Dr4AsU5aITrs4BiZMF58" alt="토스페이먼츠와 계약 후 발급된 연동상점정보(MID/ MertKey)를 기재" data-size="original">
{% endtab %}
{% endtabs %}


---

# 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://portone.gitbook.io/docs/ready/2.-pg/payment-gateway/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.