# KSNET 설정

{% hint style="warning" %}
**Deprecated**

이 문서는 더 이상 관리되지 않습니다.

[PortOne 개발자센터](https://developers.portone.io/)를 이용해주세요.
{% endhint %}

## 인증결제

{% tabs %}
{% tab title="테스트 연동 설정" %}
**테스트 환경 구성 방법**

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

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

   * mid : `2999199999`
   * apiKey : `Mjk5OTE5OTk5OTpNQTAxOkE0RTc2QkRBMzM3RENDQTk1Mjk4RkI0OTVBODREMzY5`

   <figure><img src="/files/9wkKd2IMuxOnC0vHQwKf" alt=""><figcaption></figcaption></figure>
5. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 `ksnet.2999199999`를 입력\\

{% hint style="warning" %}
공용 테스트 상점 아이디 (`2999199999`) 유의사항

* **결제 후 일정 시간 뒤에 자동 취소되기 때문에 포트원 관리자페이지에서 표시되는 결제 상태와 실제 결제 상태가 다를 수 있습니다.**
* 신용카드-국민카드 결제와 계좌이체, 상품권 결제는 테스트 지원이 불가
* 가상계좌의 경우 **절대 입금하지 마시기** 바랍니다.
* 관리자페이지 주소 => <https://ksta.ksnet.co.kr/ui/tsk/ath01/cob/athcob01m0.jsp> 테스트상점 아이디 : 2999199999\
  비밀번호 : kspay
  {% endhint %}
  {% endtab %}

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

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

   * 인증결제: KSNET
   * 비인증결제: KSNET API

   <figure><img src="/files/YmAtDY3jgTHsm7QoNVW1" alt=""><figcaption></figcaption></figure>
4. KSNET으로부터 전달받은 실 연동 정보 입력 후 오른쪽 하단 `저장` 버튼 클릭\\

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

{% hint style="info" %}
가상계좌 입금통보 URL 설정은 KSNET 측에 요청하여 `https://tx-gateway-service.prod.iamport.co/ksnet`로 설정해주셔야 합니다.
{% endhint %}
{% 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/ksnet.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.