결제 연동 가이드 5 / 9
NHN KCP
카드와 간편결제.
NHN KCP 는 사이트코드와 인증서(PEM) 두 개를 넣습니다. 다른 결제사보다 준비물이 하나 많지만 순서는 같습니다.
1
KCP 관리자에서 사이트코드와 인증서를 받습니다
KCP 상점관리자의 결제 관리 > 인증서 관리에서 서비스 인증서와 상점 개인키(PEM 파일)를 내려받습니다. 개인키에 비밀번호를 걸었다면 함께 기억해 두세요. 사이트코드(site_cd) 는 계약서와 관리자 상단에 있습니다. 테스트는 KCP 가 공개한 테스트 사이트코드(T0000)와 테스트 인증서를 씁니다.
2
짓미페이에 넣습니다
결제수단 탭에서 NHN KCP 에 체크하고
- KCP 사이트코드(site_cd)
- 서비스 인증서(PEM 본문): 파일을 텍스트로 열어 내용을 그대로 붙여 넣습니다.
-----BEGIN부터END-----까지. - 상점 개인키(PEM 본문) 와 개인키 비밀번호
를 넣고 저장합니다. 개인키는 취소 · 환불에만 씁니다.
3
테스트 결제
테스트 모드에서 KCP 를 고르면 테스트 결제창이 뜹니다. KCP 가 안내한 테스트 카드로 승인합니다.
이렇게 보이면 성공
결제 내역에 "kcp" 결제 완료가 보이고, 결제 상세의 결제 취소가 됩니다.
운영 전환
운영 사이트코드와 운영 인증서로 바꿔 넣고 테스트 모드를 끕니다. 인증서는 유효기간이 있으니 만료 전에 KCP 관리자에서 갱신해 다시 붙여 넣습니다.
막히면
"인증서 오류": PEM 본문을 붙여 넣을 때 앞뒤 줄이 잘렸거나 줄바꿈이 바뀐 경우입니다. 메모장이 아니라 원본 파일 내용을 그대로 복사하세요. 결제는 되는데 취소가 안 돼요: 개인키 비밀번호가 틀렸거나 개인키가 서비스 인증서와 짝이 아닙니다.