# Offline PG 연동현황

### 💁‍♀️ Offline PG란?

오케이포스에서 제공하는 **Offline PG 결제**는 오프라인 매장에서도 PG(Payment Gateway, 결제대행사) 를 통해 카드 결제를 지원하는 기능입니다. 일반적으로 PG는 온라인 쇼핑몰에서 카드 결제나 계좌이체 등을 중계하는 역할을 하지만, 오케이포스는 이 기능을 **오프라인 매장 환경에서도 활용할 수 있도록** 구현했습니다.

✅ VAN사 별 Offline PG 연동현황 확인 후 **PG 계약은 VAN 사로 문의**

✅ **Offline PG + VAN 승인 방식**: Offline PG 거래 거절 건 → VAN TID로 누락 없이 승인

❗<mark style="color:red;">POS/KIOSK 모두 설정가능하며 다중사업자는 사용 불가</mark>

***

### 🛠️ Offline PG 설정 프로세스

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2FFjh7HotOobaILKtzckSy%2FGroup%20883.png?alt=media&#x26;token=f47ded70-4cec-45dc-83d8-0a703cdaaea5" alt=""><figcaption></figcaption></figure>

***

### 1️⃣ VAN사 별 Offline PG 연동현황

* 연동 프로그램: POS 1.0 +  KIOSK 1.0 / Plus + KIOSK 1.0 / KIOSK 1.0 단독
* 단, KOVAN Plus 공용서버만 사용 가능

<table><thead><tr><th width="60.75">번호</th><th width="121">VAN사명</th><th width="90.25">PG 연동 여부</th><th>VAN사 별 'TID' 설정 참고</th></tr></thead><tbody><tr><td>1</td><td>KIS</td><td>✅ 연동</td><td><a href="../2-van/kis_secu">KIS SECU 설정방법</a></td></tr><tr><td>2</td><td>JTNet</td><td>✅ 연동</td><td><a href="../2-van/jtnet_secu">JTNet SECU 설정방법</a></td></tr><tr><td>3</td><td>KOVAN</td><td>✅ 연동</td><td><a href="../2-van/kovan_secu">KOVAN SECU 설정방법</a></td></tr><tr><td>4</td><td>SMARTRO</td><td>✅ 연동</td><td><a href="../2-van/smartro_secu">SMARTRO SECU 설정방법</a></td></tr></tbody></table>

* 그 외 VAN PG는 VAN 사에 문의주세요.

***

### 2️⃣Offline PG 설정방법

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2F77lEJBsd3mjKquDUAOb8%2FPG%EC%BC%9C%EA%B8%B0.png?alt=media&#x26;token=45c8bbc0-98cd-45d6-846b-531abde935f6" alt=""><figcaption></figcaption></figure>

① 대리점 영업정보시스템 매장환경설정에서 Off PG 설정을 사용으로 설정해주세요.

* 메뉴위치: 대리점 영업정보시스템 > 시스템관리 > 본사/매장마스터 > 매장환경설정
* 매장환경Tab > 특이매장옵션> \[932] OFFLINE\_PG 사용여부-“사용”

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2FrdA3jcmQBasSppxvyd0q%2Fimage.png?alt=media&#x26;token=fc35d1ac-959a-44b5-8ab3-7a42613b19ff" alt=""><figcaption></figcaption></figure>

② PG 설정을 사용처리 한 후 매장마스터에서 활성화된 터미널번호 입력창에 PG계약번호(MID)를 저장하세요.

③ Offline PG 설정 시 온라인으로 결제 불가한 내역까지 결제하기 위해 VAN TID도 함께 연결합니다.

***

### 3️⃣ 밴사 별 AGENT

* 설정 방법은 기존과 동일, 단 <mark style="color:red;">**KIS / KOVAN**</mark>은 PG 결제를 위한 별도 AGENT 설정 필요

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2FrlCG0nFvdrVW1Nxe1Tcl%2Fimage.png?alt=media&#x26;token=d3c6b77b-debb-4dca-9aac-97cc28657b06" alt=""><figcaption></figcaption></figure>

{% tabs %}
{% tab title="KOVAN" %}

### KOVAN

① 대리점 영업정보시스템 매장환경설정에서 \[932] OFFLINE\_PG 값을 설정해야 합니다.

* 메뉴위치: 매장환경Tab > 특이매장옵션> \[932] OFFLINE\_PG 사용여부-“사용”

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2Feov2FGi098PI7fJ12YvN%2Fimage.png?alt=media&#x26;token=a929250c-6988-4806-ae72-4e9626495a7a" alt=""><figcaption></figcaption></figure>

② PG 설정 후 매장마스터에서 활성화된 터미널번호 입력창에 PG계약번호(MID)를 저장하세요.

* 메뉴위치: 매장정보관리 > VAN사 설정 > 포스별 터미널번호설정 – 터미널 번호(Offline PG) : PG TID 입력, 터미널 번호 : VAN TID 입력

<br>

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2FiAUUf0h5ycePHGra3jRS%2Fimage.png?alt=media&#x26;token=fdaea528-66f7-4d05-8b61-795c8894394f" alt=""><figcaption></figcaption></figure>

③ KOVAN VAN 이라면 에이전트 추가 설정이 필요합니다.

* KOVAN AGENT > 단말기인증 > 좌측 상단에 “다중사업자활성화” 필요 (대리점)
* KOVAN AGENT > 단말기인증 > 단말기번호에는 PG TID 입력 (VAN 전산에 PG TID + POS TID 연계 등록 필요)

<mark style="background-color:yellow;">\[OFF-PG 승인 실패 알럿 팝업 제거 방법]</mark>

KOVAN 시스템에서 VAN AGENT 연동 시 간헐적으로 '승인실패' 알럿 팝업이 뜨는 경우가 있습니다.\
이는 일시적으로 발생하는 현상으로, 확인 버튼을 누르시면 ★정상적으로 승인★ 이 진행됩니다.

하지만 해당 알림 팝업은 가맹점의 문의를 유발할 수 있습니다.\
이에 따라 OKPOS에서는 아래와 같이 알림 팝업 제거를 위한 가이드를 제공드립니다.

① 장비 'C드라이브' 폴더 이동 > 'KOVAN' 폴더 이동 > 'Config' 폴더 이동 > setup.ini 클릭하세요.\
② '\[SETUP]8324MSG=OFF' 입력 후 저장하세요.
{% endtab %}

{% tab title="KIS" %}

### KIS

① 대리점 영업정보시스템 매장환경설정에서 \[932] OFFLINE\_PG 값을 설정해야 합니다.

* 메뉴위치: 매장환경Tab > 특이매장옵션> \[932] OFFLINE\_PG 사용여부-“사용”

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2FEpBaTSCiGdUkSxoW0wpq%2Fimage.png?alt=media&#x26;token=525659d0-d427-4631-8670-de987039f9e6" alt=""><figcaption></figcaption></figure>

② PG 설정 후 매장마스터에서 활성화된 터미널번호 입력창에 PG계약번호(MID)를 저장하세요.

* 메뉴위치: 매장정보관리 > VAN사 설정 > 포스별 터미널번호설정 – 터미널 번호(Offline PG) : PG TID 입력, 터미널 번호 : VAN TID 입력

<br>

<figure><img src="https://684490627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv69WyUBA97LF6ssfVxBb%2Fuploads%2F8MzchPTzeeHAxACBiivO%2Fimage.png?alt=media&#x26;token=87c79659-eb4b-46aa-9970-3dc1d26b9970" alt=""><figcaption></figcaption></figure>

③ KIS VAN 이라면 에이전트 추가 설정이 필요합니다.

* KIS AGENT > 옵션 > 가맹점 정보 > \[가맹점 등록] > \[구분] 메뉴를 \[복수]
* 단말기 번호를 PG TID로 입력  \
  최초 설치 시 반드시 가맹점정보를 다운로드 하여 KIS-AGENT의 단말기번호를 설정
  {% endtab %}
  {% endtabs %}
