⚠️ 결제키는 중요한 정보이므로 외부에 노출되지 않도록 주의해 주세요. 스텝페이를 통해 계약한 MID/CID 값으로만 이용 가능합니다. 타 호스팅사를 통해 발급받은 키값 사용 확인 시, 별도 안내 없이 서비스가 중지될 수 있으며 이에 대한 모든 책임은 가맹점에게 있습니다.
⚠️ 고객대상 판매를 시작할 경우 반드시 테스트모드의 PG는 삭제해주세요. 추가 테스트가 필요할 경우, 포탈 계정을 추가로 생성하여 테스트를 진행하실 것을 권장드립니다.
Step1: PG사 추가하기
1) 포탈 관리자페이지 [설정 → PG 연동 관리] 접근
2) 우측 상단의 [PG사 추가] 버튼을 클릭하여 가입하신 PG사를 선택합니다.
Step2: 결제 수단 선택 및 Key 입력하기
1) 연동희망하는 결제수단을 선택합니다.
☝️ 단건/정기 상품을 모두 판매하시는 경우, 결제 수단에서 '카드 정기결제(빌링)' 과 '카드 단건결제' 각각 추가 후 그에 맞는 Key를 입력해주셔야 합니다.
2) 테스트 모드 해제해주세요.
테스트 모드를 해제해야 실 결제용 Key 입력 필드가 나타납니다.
3) PG사에서 발급받은 MID, CID, TID 등 결제용 Key를 입력합니다.
4) 저장
Step3: 해외결제 Key 입력하기 (해외결제 애드온 사용시)
☝️ 해외결제를 이용하기 위해서는 해외결제 애드온이 활성화되어야 합니다. 해외결제 애드온 추가를 원하실 경우 [email protected] 또는 인터콤을 통해 별도 문의바랍니다.
포탈 관리자페이지 [설정 → 해외 판매 설정] 접근
판매 지역을 '해외'로 설정한 후, 계약한 PG사 및 결제 수단을 선택합니다.
PG가입 시 승인된 승인 통화 및 연동키를 입력합니다.
KSnet의 경우 MID, API KEY 값 입력이 필요합니다.
PG사 별 Key값 확인 방법
각 PG사별로 MID, Merchant Key, API Key를 발급받는 방법은 다릅니다. PG사별 절차에 따라 Key를 발급받아 해당 필드에 정확히 입력해야 합니다.
나이스페이먼츠 for Startup
스타트업 관리자 페이지에 접속 → 개발정보 → [+ 발급] 버튼을 눌러 키를 발급 받을 수 있습니다.
[서버(Server) 승인] / [베이직(Basic) 인증] 방식으로 선택한 뒤 발급하기 버튼을 클릭합니다.
발급된 키를 클릭하면 자동으로 복사됩니다. 각각 clientKey, secretKey 를 알맞은 필드에 입력하면 됩니다.
⚠️ 키 발급 받으실때 반드시 [서버(Server) 승인] / [베이직(Basic) 인증] 방식으로 설정하여 키를 발급받아주세요. 설정 방식이 위와 다를 경우 통신 오류가 발생합니다.
나이스페이먼츠
나이스페이의 경우, 일반 결제용 MID 와 빌링 결제용 MID 가 따로 메일로 발송됩니다.
*보통 아이디에 1이 포함되어 있는 ID가 일반 결제용, 2가 포함되어 있는 ID가 빌링 결제용 입니다.가맹점 관리자 페이지에 로그인 후, 좌측 상단의 가맹점명 끝에 ‘비인증' 이라고 쓰여져 있는 경우 빌링 결제 MID입니다.
가맹점 관리자 페이지에서 > 가맹점 정보 > KEY 관리 메뉴에서 KEY 파일을 확인할 수 있으며, 각각의 아이디로 로그인 하여야 합니다.
상점 아이디(MID)에 따라서 정기 결제 키와 단건 결제 키가 나눠져 있으니 잘 구분하여 입력해주세요. (정기 결제 MID의 경우, 앞에 ‘b_’ 가 포함되어 있습니다.)
KG 이니시스
PG사 상점아이디(MID): 상점 아이디 입니다. 메일에서 확인 가능합니다.
빌링결제 SignKey: 결제 연동에 꼭 필요한 Key입니다. 가맹점관리자페이지 → 상점정보 → 계약정보 → 부가정보 → 웹결제 signkey 생성 조회 → 조회 에서 확인할 수 있습니다.
빌링결제 LiteKey: 가맹점관리자페이지 → 상점정보 → 계약정보 → 부가 정보 → INILite/Express Key 생성 갱신 조회 → 조회 에서 확인할 수 있습니다.
빌링결제 APIKey: 가맹점관리자페이지 → 상점정보 → 계약정보 → 부가정보 → INIAPI key 생성 갱신 조회 → 조회 에서 확인할 수 있습니다.
토스페이먼츠
토스페이먼츠 로그인 이후 개발자센터(내 개발정보 확인) > API 키
라이브 탭을 클릭 > 클라이언트 키, 시크릿 키를 각각 복사 및 포탈에 입력합니다.
API 개별 연동키를 확인하여 입력
카카오페이
가입 완료 후 받은 메일에 기입되어 있습니다.
어드민 키: 계정과 관련된 모든 권한을 가지고 있는 Key입니다. kakao developers → 내 애플리케이션 → 앱 설정 → 앱 키 에서 확인하실 수 있습니다.
다날
다날 가입 완료 후 받은 메일에 기입되어 있습니다.
페이플
페이플 가입 완료 후 받은 메일에 기입되어 있습니다.
KSnet
발급받은 KSnet 관리자 접속
PG 상점정보 메뉴 > 상점정보 > Search 클릭 이후 상점정보의 상점 ID 클릭
상점 ID 및 pgapi 복사
반드시 단건결제, 정기결제의 MID 및 PG APIKEY 를 구분해서 입력해주세요
단건결제는 ‘기업명’ 혹은 ‘기업명_인증’이라는 이름의 상점(어드민계정)의 정보를 입력
정기결제는 ‘기업명_N’ 혹은 ‘기업명_비인증’이라는 이름의 상점(어드민계정)의 정보를 입력