개발·연동
빌링키
Billing Key / Payment Token
한눈에 보는 정의
빌링키는 등록된 결제수단을 참조해 이후 결제를 요청할 때 사용하는 값이에요. 고객의 카드번호 자체나 이미 완료된 결제의 식별자와는 달라요.
함께 찾는 표현: 결제 토큰, billingKey
이 문서에서
등록과 결제는 어떻게 다른가요?
빌링키 발급은 나중에 사용할 결제수단을 등록하는 단계예요. 실제 요금을 받으려면 그 값을 이용해 결제를 요청하고 승인 결과를 확인해야 해요. 발급 성공만 보고 첫 달 요금이 결제됐다고 처리하면 안 돼요.
결제 흐름 예시
고객이 구독용 카드를 등록하면 상점은 고객과 빌링키의 연결을 관리해요. 다음 청구일에 약정한 요금을 요청하고, 해당 회차의 결제 식별자를 따로 저장해요. 하나의 빌링키로 여러 회차의 서로 다른 결제가 생길 수 있어요.
암호화된 카드번호인가요?
카드 원문을 단순 암호화한 값이라고 단정하지 마세요. 예를 들어 토스페이먼츠는 결제정보와 연결된 고유 토큰을 이용한다고 설명해요. 내부 형식은 사업자별로 다르므로 직접 해석하거나 다른 PG로 복사해 사용할 수 있다고 가정하면 안 돼요.
운영에서 확인할 점
빌링키는 결제에 사용될 수 있으므로 접근을 제한해야 해요. 고객 연결, 결제 동의, 해지 후 청구 중단, 카드 변경 시 재등록을 함께 관리하세요. 원문 카드번호를 복원할 수 없다는 사실이 오용 위험까지 없다는 뜻은 아니에요.
참고 자료
예시는 가상의 상황입니다.
- 토스페이먼츠 · 자동결제
빌링키는 카드 원문 자체가 아니라 결제정보와 연결된 토큰이라는 설명
- 토스페이먼츠 · 자동결제 API 연동
빌링키 발급과 자동결제 요청 분리
자료 확인일:
지금 내는 PG 수수료, 적정한지 확인해 보세요
서포트비에서 견적 요청서 하나로 여러 PG사의 수수료·정산 조건을 받아 한 화면에서 비교할 수 있어요.
무료로 PG 견적 비교하기