API Reference > KCP PG-API
KCP PG-API
KCP PG-API
서비스 인증서와 개인키
1) 파트너관리자 로그인을 진행해 주세요.
2) 기술관리센터 > 인증센터 > KCP-PG API 메뉴에서 서비스 인증서와 개인키 발급해 주세요.
3) 최초 발급 시 서비스 인증서와 개인키가 함께 발급됩니다.
PC 다운로드 폴더에서 KCP_AUTH_사이트코드_CERT 형태의 폴더를 확인해 주세요.
KCP_AUTH_사이트코드_CERT.pem 은 서비스 인증서 파일,
KCP_AUTH_사이트코드_PRIKEY.pem 은 개인키 파일입니다.
✅ 개인키는 외부로 노출되지 않도록 주의해 주세요.
✅ KCP PG-API 서비스 인증서의 유효기간은 5년으로 유효기간 만료 30일 전부터 재발급이 가능합니다.
✅ 개인키 비밀번호 분실 또는 파일을 분실했을 경우 폐기 후 재발급이 필요하니 관리에 유의 바랍니다.
✅ 개인키를 폐기할 경우 기존 사용 중인 개인키와 서비스 인증서는 승인/취소/조회 등 모든 서비스 사용이 불가합니다.
서비스 인증서 적용하기
발급받은 서비스 인증서 파일 내부 값을 텍스트 값으로 전달해 주셔야 합니다.
kcp_cert_info 값 적용 시에는 서비스 인증서 텍스트 값을 직렬화하고, 시작/종료 구분자까지 포함하여 value 값으로 전달해 주세요.
📍kcp_cert_info는 결제 승인, 거래취소 시에 필요합니다.
"kcp_cert_info" : "-----BEGIN CERTIFICATE-----MIIDgTCCAmmgAwIBAgIHBzKxiAs+9jANBgkqhkiG9w0BAQsFADBzMQswCQYDVQQGEwJLUjEOMAwGA1UECAwFU2VvdWwxEDAOBgNVBAcMB0d1cm8tZ3UxFTATBgNVBAoMDE5ITktDUCBDb3JwLjETMBEGA1UECwwKSVQgQ2VudGVyLjEWMBQGA1UEAwwNc3BsLmtjcC5jby5rcjAeFw0yNjA2MjkwNjEwNTdaFw0zMTA2MjgwNjEwNTdaMHAxCzAJBgNVBAYTAktSMQ4wDAYDVQQIDAVTZW91bDEQMA4GA1UEBwwHR3Vyby1ndTERMA8GA1UECgwITG9jYWxXZWIxETAPBgNVBAsMCERFVlBHV0VCMRkwFwYDVQQDDBAyMDIxMDYyOTEwMDAwMDI0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAppkVQkU4SwNTYbIUaNDVhu2w1uvG4qip0U7h9n90cLfKymIRKDiebLhLIVFctuhTmgY7tkE7yQTNkD+jXHYufQ/qj06ukwf1BtqUVru9mqa7ysU298B6l9v0Fv8h3ztTYvfHEBmpB6AoZDBChMEua7Or/L3C2vYtU/6lWLjBT1xwXVLvNN/7XpQokuWq0rnjSRThcXrDpWMbqYYUt/CL7YHosfBazAXLoN5JvTd1O9C3FPxLxwcIAI9H8SbWIQKhap7JeA/IUP1Vk4K/o3Yiytl6Aqh3U1egHfEdWNqwpaiHPuM/jsDkVzuS9FV4RCdcBEsRPnAWHz10w8CX7e7zdwIDAQABox0wGzAOBgNVHQ8BAf8EBAMCB4AwCQYDVR0TBAIwADANBgkqhkiG9w0BAQsFAAOCAQEAt8c1yT65AP32LOAaADoPelluhBgFVYEiFNOTTjO34ZO5X17ySAzQmIKc+3K4TesH46zSe1F91CBvBLjUCvWgzrycevdtqinOgDkN3J9zSGc5aw5sRISrK4mdQ/Hx/TtT6mc2jiuJo4k6iBWWMtJnCOHl9urei3HIMR8quRIHMCFDfCpkjXezEUvM3kw6TCCeTkII7K+RZxQRyhI1xJzLsCMl1I9H+Znt/aBjFz4MWayXmE6yFZ+GpT+BL5lG/J9PSUQLb5mVp7+PXJhepSQRYDYrvtX5oL8J6CZz91K8gxJxD2qX1AI72Pej4M9lVDLGtvVfndE4bazMZEyj2O42hw==-----END CERTIFICATE-----";