자주묻는질문

  • Q. API 결제연동 중 "S000 필수값 누락 (XXX)" 오류가 발생합니다.

    필수값이 누락된 경우 발생하는 오류이며, 누락된 파라미터명은 괄호안의 내용으로 확인 가능하니 참고 부탁드립니다.
    ex) "S000 필수값 누락 (kcp_cert_in)인 경우 인증서 값 누락된 경우 입니다."

  • Q. API 결제 연동 중 "S031 인증서 검증 오류"가 발생했습니다.

    서비스인증서 정보가 올바르지 않은 경우 발생하는 오류입니다.
    연동하시려는 환경에 맞게 사이트코드/서비스인증서/target_URL 이 셋팅되어있는지 확인 바랍니다.

    ex) 테스트 사이트코드, 운영계 서비스인증서, 개발서버 target_URL 로 진행 시 또는
    운영계 사이트코드, 테스트 서비스인증서, 운영서버 target_URL로 진행시 발생합니다.

    target_URL = "https://stg-spl.kcp.co.kr/gw/enc/v1/payment"; // 개발서버
    target_URL = "https://spl.kcp.co.kr/gw/enc/v1/payment"; // 운영서버

  • Q. API 결제 연동 중 "S032 접근권한이 없습니다." 오류가 발생했습니다.

    ① 가맹점에 발급된 서비스인증서로 요청하지 않을 경우 발생할 수 있습니다.
    kcp_cert_info 값에 가맹점 사이트코드로 발급된 서비스인증서 값을 직렬화하시어 전달해주시는지 확인 부탁드립니다.

    추가로 kcp_cert_info 값에 개인키파일을 전달하고 계시진 않은지 확인 부탁드리며,
    개인키파일은 kcp_sign_data를 생성하는 로직에서 경로로 참조하셔서 진행해보시기 바랍니다.

    ② 서비스인증서 형식이 맞지 않는 경우 오류로 kcp_cert_info 값이 올바른지 확인 부탁드립니다.
    ex) kcp_cert_info 값이 null인 경우, 구분자(----BEGIN CERTIFICATE----)가 누락된 경우 등

  • Q. API 취소 연동 중 "S034 인증서 검증 오류"가 발생했습니다.

    서명데이터(kcp_sign_data)가 올바르지 않은 경우 발생하는 오류로 서명데이터(kcp_sign_data)는
    거래정보를 개인키로 SHA256withRSA 알고리즘으로 인코딩해서 전달해주시기 바랍니다.

    ex) kcp_sign_data 생성시 아래내용 중 mod_type 이 잘못되어있는 경우 S034 오류 발생
    ORG_SIGN_DATA = T0000^20220101234567^PACA;

    전체취소시에는 ORG_SIGN_DATA = T0000^20220101234567^STSC; 로,
    부분취소시에는 ORG_SIGN_DATA = T0000^20220101234567^STPC; 로 전달해주시기 바랍니다.

  • Q. API 결제 연동 중 "SXC1 SPL 연동 오류"가 발생했습니다.

    API 통신시 필수값이 누락된 경우 발생하는 오류입니다.
    필수 값이 JSON 형식으로 정상적으로 전달되는지 확인해주시기 바랍니다.

    ex) tran_cd, site_cd, kcp_cert_info, enc_data, enc_info, ordr_mony

  • Q. API 개발테스트에 대한 서비스인증서 및 개인키는 어디서 받을 수 있나요?.

    아래 경로 안내드리니 아래 경로 통해 다운로드 해주시기 바랍니다.

    개발지원센터(developer.kcp.co.kr) > 기술지원 > 다운로드자료실 > Certificate lib
    서비스인증서 : kcp_cert, 개인키 : Private key

  • Q. API API 방식 연동 중입니다. 테스트서버에서 실서버로 변경시 소스 변경사항 문의드립니다.

    1. order 페이지 내 site_cd값을 실운영 사이트코드로 변경
    ex) T0000은 테스트서버용 사이트코드이기 때문에 계약 시 부여받은 실 운영 사이트코드로 변경해주시기 바랍니다.

    2. kcp_api_page 페이지 내 target_url 운영서버로 변경
    개발서버 : String target_URL = "https://stg-spl.kcp.co.kr/gw/enc/v1/payment";
    운영서버 : String target_URL = "https://spl.kcp.co.kr/gw/enc/v1/payment";

    3. kcp_api_page 페이지 내 서비스인증서 정보(kcp_cert_info) 변경
    ex) 개발계 서비스인증서가 아닌 당사를 통해 발급받은 운영계 서비스인증서로 변경 바랍니다.

    4. pc 결제창 호출 js 설정 변경(샘플소스 기준 order 페이지)
    개발 : https://testspay.kcp.co.kr/plugin/kcp_spay_hub.js
    운영 : https://spay.kcp.co.kr/plugin/kcp_spay_hub.js

    5. 모바일 거래등록 url 설정 변경(샘플소스 기준 kcp_api_trade_reg페이지)
    개발 : String target_URL = "https://stg-spl.kcp.co.kr/std/tradeReg/register";
    운영 : String target_URL = "https://spl.kcp.co.kr/std/tradeReg/register";

  • Q. API 연동시 ERR_SSL_VERSION_OR_CIPHER_MISMATCH 오류가 발생합니다.

    ssl관련 오류 발생하는 것으로 예상됩니다.
    가맹점 서버환경이 TLS 1.2를 지원하는 부분인지 확인 부탁드립니다. API의 경우 TLS1.2 이상에서만 진행이 가능한 점 참고 부탁드립니다.