'KICC_일반결제방식' 실운영모드 설정 및 연동방법과 관련하여 안내 드립니다.
[KICC_일반인증결제 PG설정방법_실운영모드]
1. PG 설정
포트 관리자콘솔( https://admin.portone.io/ ) 로그인 → 결제연동→ 실 연동관리 →실연동 → 헥토파이낸셜→ 헥토파이낸셜→ 추가 후 상점정보 입력 및 저장.
•
PG상점아이디 (MID) / auth_key >> KICC측에서 계약 완료후 별도 안내 드립니다.
<포트원_KICC_일반결제_실운영모드 설정화면 예시>
[가상계좌를 이용하는 경우 필수설정]
구매자가 가상계좌로 입금을 하게되면, PG사로부터 '입금완료' 통지가 전달되고 있습니다.
(PG사 → 포트원 → 가맹점 순)이에 따라 아래와 같이 입금통지를 받을 수 있는 두가지의 URL설정이 필요합니다.
•
가상계좌 입금통보URL : PG사로부터 통지받을 “포트원의 서버 URL” (PG사에 설정필요)
•
웹훅URL : 포트원으로부터 통지받을 “가맹점의 웹서버URL” (포트원 관리자페이지에 설정필요)
1) 가상계좌 입금통보URL 설정 (PG사 → 포트원 서버 입금완료 통지)
- 설정 방법 : KICC -> 포트원 입금에 대한 통보를 받기 위해 가맹점에서 KICC에 URL을 등록 진행 절차 필요합니다.
아래의 URL 정보 KICC 담당자에게 등록요청부탁 드립니다.(KICC사용하는 모든 가맹점 동일)
[KICC담당자 정보]
- 가상계좌 입금통보 URL : https://service.iamport.kr/kicc_payments/notice_vbank
2) 웹훅 URL(Notification url) 설정
- 설정 방법 : 포트원 관리자콘솔( https://admin.iamport.kr ) →결제연동 → 실 연동 관리 → 실 결제 전용 결제알림 (Webhook)을 통해 통지를 받습니다.
- 참고 : PG사에서 통지 받는대로 포트원 서버가 일종의 클라이언트 역할을 하여 지정된 URL로 POST요청을 보내는 개념으로 해당 URL을 통해 가상계좌 입금 여부 확인 가능합니다.
- 웹훅 연동매뉴얼 : https://portone.gitbook.io/docs/result/webhook
- 워드프레스 '우커머스플러그인' 이용시 설정 방법 : 웹훅URL 자동설정(버전 2.1.11 이상 지원)
- 워드프레스 포트원 '결제버튼생성플러그인' 이용시 설정 방법 : https://portone.gitbook.io/docs/wordpress/wordpress/button 의 STEP2 가맹점 정보 입력하기에서 "0. 가상계좌 입금통보 설정"의 가상계좌 입금통보 URL을 그대로 복사하여 포트원 리자페이지 > 시스템설정 > 웹훅(Notification 설정) 에 설정 해 줍니다.
<웹훅 설정 화면 예시>
2. 결제 연동
- KICC_일반결제방식_연동 샘플페이지 : https://github.com/iamport/iamport-manual/blob/master/인증결제/sample/kicc.md
- 일반인증결제 통합 연동 매뉴얼 : https://portone.gitbook.io/docs/auth/guide
- 포트 REST API 문서 : https://api.iamport.kr/
- 복수 PG 설정 및 사용하기 : https://portone.gitbook.io/docs/console/pg
<KICC_ 결제연동 파라메터 정보>
- pg : kicc
