안녕하세요, apick 입니다.
개인통관고유부호 관련 API 3종이 새 인증 방식으로 전면 교체되었습니다. 기존 방식으로 연동하신 경우 API를 새로 연동하셔야 정상 동작합니다.
변경 요약
| 기존 (A방식) |
변경 (B방식) |
|
인증번호 문자 수신 후 입력
|
카카오톡·토스·PASS 등 간편인증 앱 승인
|
|
요청 즉시 결과 반환
|
요청 → tx_id → 조회 2단계
|
|
검증 API 별도 제공
|
검증 API 종료, 조회 API로 통합
|
종료된 API
POST /rest/check_pccc (개인통관고유부호 검증) → 서비스 종료
- 검증이 필요하시면 조회 결과를 직접 비교하는 방식으로 변경해 주세요.
변경된 API
1) POST /rest/req_pccc — 개인통관고유부호 인증 요청
요청 파라미터가 바뀌었습니다.
name (필수) 이름birthday (필수) 생년월일 8자리 (YYYYMMDD) — 기존 주민등록번호 13자리는 더 이상 받지 않습니다.phone (필수) 휴대전화 번호 (숫자만)provider (필수) 간편인증 방식ttlMs 삭제 — 인증 유효시간은 5분 고정입니다.
지원하는 provider 값: kakao, naver, toss, pass, samsung, kb, shinhan, hana, woori, ibk, nh, kakaobank, banksalad
응답으로 결과 조회에 사용할 tx_id 를 즉시 반환합니다.
2) POST /rest/get_pccc — 개인통관고유부호 조회
- 인자로
tx_id 만 받습니다. (기존 name·birthday·phone·provider 전달 방식 삭제)
- 인증 접수는 반드시
req_pccc 를 먼저 호출해 주세요.
처리 흐름
req_pccc 호출 → 사용자 휴대폰으로 간편인증 요청 발송, tx_id 즉시 응답- 사용자가 인증 앱에서 직접 승인 (5분 내 미승인 시 인증 실패 → 재요청 필요)
get_pccc 에 tx_id 를 넣어 결과 확인
과금 안내
req_pccc: 인증 요청이 실제 발송된 경우에만 과금됩니다. 발송 실패 시 무과금이며, 이미 대기 중인 요청을 다시 보내면 재발송 없이 기존 tx_id 를 반환하고 과금되지 않습니다.get_pccc (승인 전): status: "pending", message: "인증 대기중입니다." 를 반환하며 무과금입니다.get_pccc (승인 완료 후): 조회 결과를 반환하며 과금됩니다. 결과는 수집 시각(checked_at) 기준 24시간 동안 재조회할 수 있고, 재조회할 때마다 과금됩니다. 24시간이 지나면 status: "expired" 가 반환되며 재인증이 필요합니다.
응답 주요 필드
tx_id — 트랜잭션 IDstatus — pending / verified / expired / failedmessage — 상태 메시지checked_at — 정보를 실제로 수집한 시각 (ISO 8601, verified 일 때)개인통관고유부호, 이름, 주소, 전화번호, 사용여부 — verified 일 때error — 실패 시 오류 메시지
요청 예시
curl -k -X POST "https://apick.app/rest/req_pccc" \
-H "CL_AUTH_KEY: $API_KEY" \
--form 'birthday="19900101"' \
--form 'phone="01011112222"' \
--form 'provider="kakao"'
curl -k -X POST "https://apick.app/rest/get_pccc" \
-H "CL_AUTH_KEY: $API_KEY" \
--form 'tx_id="9f2c4a7b1d8e35c60a4f7b2d1e9c80bb"'
자세한 내용은 개발가이드에서 확인하실 수 있습니다.
기존 방식을 사용 중이신 고객님께서는 API 재연동을 부탁드립니다. 감사합니다.
