# 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="https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fgit-blob-e00310aa897347931ada6e99e945d804aefd93b0%2Fksnet-setup-test.png?alt=media" alt=""><figcaption></figcaption></figure>
4. 테스트 연동 정보 확인 후 오른쪽 하단 `저장` 버튼 클릭

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

   <figure><img src="https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fgit-blob-5850596c763793109be2ae00bf55d4c0601b959b%2Fksnet-setup-test-2.png?alt=media" 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="https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fgit-blob-8ce5a7e08aa48ef88c1f62e4f79d010b034325bd%2Fksnet-setup.png?alt=media" alt=""><figcaption></figcaption></figure>
4. KSNET으로부터 전달받은 실 연동 정보 입력 후 오른쪽 하단 `저장` 버튼 클릭\\

   <figure><img src="https://2409678497-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwWX2hlvRZLZrXeH1aacF%2Fuploads%2Fgit-blob-330e27d79e943f2d9a166c3f8544b5dbae274f3f%2Fksnet-setup-2.png?alt=media" alt=""><figcaption></figcaption></figure>
5. 등록 완료 후, 결제 요청 SDK의 PG 파라미터에 `ksnet.실연동상점아이디`를 입력

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