---
description: (주)케이에스넷 연동시 주의사항을 확인할 수 있습니다.
---

# 연동 주의사항

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

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

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

<details>

<summary>계약 확인사항</summary>

**아임포트를 통한 ksnet 이용 가맹점의 상점아이디 과세 설정은 반드시 `복합과세` 로 설정되어 있어야 합니다. 일반과세 , 면세 설정은 지원하지 않습니다.**

* 키인결제
* 가맹점 부담 무이자 할부 설정
* 가상계좌 마감일시 지정
* 가상계좌 환불
* 간편결제 사용
* 할부 사용
* 에스크로 사용, 배송 에스크로만 지원
  * ksnet에서 일반 에스크로, 배송 에스크로 두가지 유형의 에스크로를 제공합니다. 아임포트를 통해 ksnet 에스크로를 사용하려는 경우 반드시 **배송에스크로** 설정이 되어 있어야 합니다.
* 휴대폰 결제 시 상품 유형 설정(실물 혹은 디지털)

</details>

<details>

<summary>특정카드사 가맹점 부담 무이자 할부 설정 불가</summary>

ksnet에서 가맹점 부담 무이자 할부 설정에 필요한 카드 코드 정보를 일부 카드사에 대해서만 제공하고 있습니다. 카드코드가 제공되지 않는 일부 카드사의 경우 가맹점 부담 무이자 할부를 설정할 수 없습니다.

</details>

<details>

<summary>계좌이체</summary>

**결제창에서 현금영수증 발급 시 사업자번호, 휴대폰 번호에 숫자만 입력해야합니다.**

계좌이체 결제창을 통한 현금영수증 발급 시 휴대폰번호, 사업자 번호는 **숫자만** 입력해야합니다. 하이픈(-) 을 포함한 다른 문자가 포함되는 경우 별다른 에러 표시 없이 결제는 진행되지만 현금영수증이 발급되지 않습니다.

</details>

<details>

<summary>가상계좌</summary>

**예금주명 지정 불가**

가상계좌의 예금주명은 가맹점명으로 고정되며 별도 지정이 불가합니다.

**부가세, 면세 금액 설정 지원 안 함**

KSPAY는 일회성 가상계좌의 경우 부가세, 면세 금액 설정을 지원하지 않습니다.

**가상계좌 입금기한은 필수 입력 항목**

ksnet에서 가상계좌 입금기한은 선택 입력항목으로 안내하고 있지만 입력하지 않을 경우 가상계좌 입금기한을 특정할 수 없고 오동작할 가능성이 있어 필수로 입력해야합니다. (아임포트에서는 필수 값으로 제한하고 있습니다.)

**가상계좌 입금기한은 초 단위 UNIX TIMESTAMP 사용**

vbank\_due 파라미터로 전달하는 가상계좌 입금기한은 초 단위의 UNIX TIMESTAMP(통상 10자리 자연수)로 입력하여야 합니다. (`api로 가상계좌를 발급하는 경우에만 해당합니다.`)

</details>

<details>

<summary>에스크로 서비스</summary>

#### 주문자 이메일 필수 입력

구매 확인을 받기 위한 주문자 이메일을 필수로 입력하여야 합니다.

#### 등록 소요 시간 존재

에스크로 거래는 30분 \~ 1시간 뒤 [ksta.ksnet.co.kr](http://ksta.ksnet.co.kr/) > PG 거래내역 > 배송 에스크로 거래조회에서 확인이 가능합니다. 에스크로 정보 수정의 경우도 등록이 완료된 이후부터 가능합니다.

#### 배송정보 발송일시는 **초 단위 UNIX TIMESTAMP 사용**

logis.sent\_at 파라미터로 전달하는 배송정보 발송일시는 초 단위의 UNIX TIMESTAMP(통상 10자리 자연수)로 입력하여야 합니다.

</details>

<details>

<summary>키인결제</summary>

판매 상품에 대한 구분값으로 **product\_type**을 파라미터로 사용해야 결제가 가능합니다.

가맹점 부담 무이자를 원하시는 경우 pg 사와의 별도의 계약 후 **interest\_free\_by\_merchant** 파라미터를 사용해야 합니다.

카드번호와 유효기간만으로 결제를 요청하는 비인증 승인 API만 연동되어 있어

**birth**(생년월일6자리 혹은 사업자등록번호10자리)와 **pwd\_2digit**(비밀번호 앞 2자리)는 검증하지 않습니다.

</details>

<details>

<summary>빌링키 결제</summary>

판매 상품에 대한 구분값으로 **product\_type**을 파라미터로 사용해야 결제가 가능합니다.

가맹점 부담 무이자를 원하시는 경우 pg 사와의 별도의 계약 후 **interest\_free\_by\_merchant** 파라미터를 사용해야 합니다.

</details>

<details>

<summary>빌링키 등록</summary>

card\_number, expiry, pwd\_2digit, birth 파라미터 입력은 필수 입니다.

</details>

<details>

<summary>기타</summary>

* 휴대폰 결제는 부분취소 불가능.
* 카드, 간편결제 외 결제의 경우 매출 전표 확인 불가능.
* 간편결제(카카오페이, 페이코) 카드 결제의 경우 ksnet측에서 카드정보(카드번호, bin) 정보를 제공해주지 않아 결제 정보에 카드사 정보가 제공되지 않습니다.
* USD 결제는 순수 해외카드로만 결제 가능합니다.
* 카카오페이 사용 시 상점정보(대표자명, 주소, 전화번호)를 필수로 입력해야합니다
* 부분취소는 총 9회까지 가능합니다. (카드결제, 가상계좌, 계좌이체, 간편결제)
* 취소는 결제일 기준 6개월 이내에만 가능합니다.
* 가상계좌 환불은 23:00\~06:00 시간 외에만 가능합니다.
* 계좌입금 거래 시 결제창에서 발급한 현금영수증은 경우 거래 취소 시 자동으로 취소 되지 않습니다.
* 복합과세의 계좌입금 거래를 부분취소하는 경우 기존에 발급한 현금영수증을 취소하고 부분취소 금액이 반영된 금액 정보로 다시 현금영수증을 발급해야합니다.
* 매출 전표 확인 시 자동으로 인쇄 기능이 호출됩니다. 오동작이 아닌 ksnet의 의도된 기능입니다.
* 간편 결제 수단에서 가맹점 부담 무이자 설정은 사용 불가능합니다.
* 간편 결제 수단에서 할부 개월 수 표시 설정은 일부 간편결제사에서만 가능합니다.
  * 네이버페이, 카카오페이, LPay: 할부 개월 수 표시 설정 가능
  * Payco, SSGPay: 할부 개월 수 표시 설정 불가, 5만원 이상 시 1\~12 개월 표시 고정

</details>

{% hint style="danger" %}
특이사항

1. 카드, 간편결제를 외 결제 수단 에서는 매출전표를 제공하지 않습니다.
2. Ksnet은 KRW, USD 만 지원합니다.
3. USD 결제의 경우 순수 해외 카드만 결제 가능합니다.
4. 페이코, 카카오페이의 경우 카드번호 혹은 카드bin 정보를 제공하지 않습니다. ⇒ 결제 정보에 일부 카드 정보가 비어 있다.
5. 카카오페이 사용 시 상점정보(대표자명, 주소, 전화번호)를 필수 입력하도록 안내하고 있지만 전달하지 않아도 결제는 동작합니다.
6. 주문자 이메일(buyer\_email)은 선택 입력 항목이지만 에스크로 결제에서 구매확인 이메일 수신을 위해 필수로 입력해야 합니다. 입력하지 않아도 결제는 동작합니다.
7. 면세 설정 상점아이디에서 면세처리를 위해 결제 금액과 동일한 면세 금액을 반드시 입력해야합니다. 그렇지 않은 경우 매출전표에 전액 면세가 아닌 것으로 표시되고 실제 처리 내역이 다를 수 있습니다.
8. 과세 설정 상점아이디에서 면세 금액을 전달하지 않아야 합니다. 면세 금액을 전달하는 경우 매출전표에 면세 처리 된것으로 표시되지만 실제 처리 내역과 다를 수 있습니다.
9. 카드, 간편결제 다이렉트 호출은 현재 지원하지 않습니다.
10. Ksnet에서 결제창에 표시되는 카드사 중 일부 카드사에 대해서만 카드코드 목록표를 제공합니다. 카드코드 목록에 없는 카드사의 경우 `가맹점 무이자 할부` 설정을 적용할 수 없습니다.
11. 결제 취소 시 부분취소는 9회까지 가능합니다. (카드결제, 가상계좌, 계좌이체)
12. 취소는 결제일 기준으로 6개월까지만 가능합니다.
13. 가상계좌 환불은 23:00\~06:00 시간 외에만 가능합니다.
14. 가상계좌 환불은 특약이 있는 가맹점만 사용 가능합니다.
15. 휴대폰 결제는 부분취소를 지원하지 않습니다.
16. 계좌입금 거래 시 발급한 현금영수증은 경우 거래 취소 시 자동으로 취소 되지 않습니다. 수동으로 취소해야합니다.
17. **아임포트를 통한 ksnet 이용 가맹점의 상점아이디 과세 설정은 반드시 `복합과세` 로 설정되어 있어야 합니다.**
18. 휴대폰 결제 시 상품유형(sndGoodType)을 디지털(2)로 결제를 진행하려면 가맹점 설정이 되어 있어야한다. 상점아이디 설정은 실물(1) 혹은 디지털(2) 중 한가지로만 설정 가능하다.
{% endhint %}
