에러 코드
"취소된 빌링키이거나 이미 만료된 빌링키입니다"(-3003)는 왜 나오나요?
가맹점이 API 로 직접 만료시켰거나, 카드 유효기간 만료·정지·분실 신고로 그 빌링키를 더 못 쓰게 된 상태입니다. 빌링키 유효기간은 KCP 가 기본 36개월이고, 다른 PG 는 카드 유효기간까지입니다.
이 코드로 들어온 상담 4건을 읽고 정리했습니다.
유효기간이 PG 마다 다릅니다
| PG | 빌링키 유효기간 |
|---|---|
| NHN KCP | 기본 36개월 |
| 그 외 PG | 카드의 유효기간까지 |
만료를 미리 잡는 방법
빌링키를 발급할 때 응답에 오는 만료일을 저장해두면, 결제일 전에 재발급을 유도할 수 있습니다. 저장해두지 않으면 나중에 왜 만료됐는지 확인할 방법이 없어 PG 에 문의해야 합니다.
카드 정지·분실처럼 사용자 쪽 사정이면 새 카드로 빌링키를 다시 받는 것 외에 방법이 없습니다. 구독 서비스라면 결제 실패 시 카드 교체를 안내하는 흐름을 미리 만들어 두세요.
기준입니다. 같은 코드라도 PG 와 계약 상태에 따라 응답 문구가 달라질 수 있습니다. 응답 본문 전체를 함께 확인하세요.