💳

KPN PG 발급 가이드

난이도⭐⭐⭐☆☆

💡 KPN PG란?

한국결제네트웍스(KPN)는 한국 PG사예요. 카드 / 네이버페이 / 카카오페이를 한 번에 통합 처리해서, 별도 통합 작업 없이 결제 기능을 시작할 수 있어요.

  • ✅ 한국 사용자 친화 (모든 결제 수단 지원)
  • ✅ 가맹 심사 1~3일 (영업일 기준)
  • ✅ Foundry 검증 완료 (5/13 prod 전환)

KPN 영업 담당자 연락

KPN은 온라인 자가 신청 안 됨 — 영업 담당자에게 직접 연락해서 가맹 신청해야 해요.

KPN 개발자센터 접속 → 우상단 "가맹 문의" 또는 "고객지원" 메뉴에서 문의.

필요 서류 준비

가맹 심사에 필요한 서류:

  • 사업자등록증 (사본)
  • 대표자 신분증
  • 통장 사본 (정산 입금 계좌)
  • 판매 품목 / 사이트 URL (있으면)

가맹 심사 (1~3일)

영업일 기준 1~3일 소요. 보통:

  • 서류 검토 → 영업 담당자 통화 → 심사 → 승인
  • 판매 품목에 따라 추가 서류 요청 가능 (예: 의료기기, 주류 등 규제 품목)

기다리는 동안 Foundry에서 다른 기능 작업 진행 가능해요. 결제 코드는 이미 적용돼 있어요.

MID + PassKey 발급

가맹 승인 후 발급되는 정보:

  • MID (Merchant ID) — 예: myshop01
  • PassKey — OTP = PassKey 그대로 (별도 발급 X)
  • PROD URL: https://pay.firstpay.co.kr

Foundry 환경변수 입력

발급 받은 정보를 Foundry 환경변수 입력 페이지에 입력해주세요:

  • KPN_MX_ID = MID (예: myshop01)
  • KPN_PASS_KEY = PassKey
  • KPN_ENDPOINT = https://pay.firstpay.co.kr
  • NEXT_PUBLIC_KPN_ENV = product

저장하면 자동 재배포되고, 결제 기능이 즉시 활성화돼요!

❓ 자주 묻는 질문

가맹 심사에 떨어지면 어떻게 하나요?
판매 품목이 KPN 정책에 안 맞을 수 있어요. 영업 담당자가 거절 사유를 알려주니, 다른 PG (예: 토스페이먼츠, 이니시스)도 고려해보세요. Foundry는 추후 다른 PG도 지원 예정이에요.
개인사업자도 가능한가요?
네! 개인사업자도 가능해요. 단, 통신판매업 신고가 필요할 수 있어요 (월 매출 4,400만원 이상 시 의무).
가맹 신청 후 며칠 안에 발급되나요?
영업일 기준 1~3일이에요. 서류 상태에 따라 더 빠르거나 (당일) 늦어질 수 있어요 (5일 이상). 서두르시면 영업 담당자에게 직접 전화로 문의 추천.
비용은 얼마인가요?
기본 가맹비 X, 결제 건당 수수료만 발생 (보통 3.3% 안팎). 정확한 수치는 KPN 영업 담당자에게 문의.
테스트 결제는 어떻게 하나요?
가맹 승인 전이라도 Dev 환경에서 테스트 가능 — KPN이 dev MID (testcorp) 를 제공. NEXT_PUBLIC_KPN_ENV=dev로 입력해서 사용 가능.

🔗 참고 링크