개발·연동
빌링키
Billing Key / Payment Token
함께 찾는 표현: 결제 토큰, billingKey
한눈에 보는 정의
빌링키는 등록한 결제수단으로 이후 결제를 요청할 때 쓰는 값이에요. 카드번호나 개별 결제를 식별하는 값과는 달라요.
이 문서에서
등록과 결제는 어떻게 다른가요?
빌링키를 발급받는 것은 나중에 사용할 결제수단을 등록하는 단계예요. 실제 요금을 청구하려면 빌링키로 결제를 요청하고 승인 결과를 확인해야 해요. 빌링키 발급에 성공했다고 첫 달 요금까지 결제된 것은 아니에요.
결제 흐름 예시
고객이 구독 요금을 낼 카드를 등록하면 가맹점은 해당 고객과 빌링키를 연결해 관리해요. 다음 청구일에 약정한 요금의 결제를 요청하고 그 회차의 결제 식별자를 따로 저장해요. 하나의 빌링키로 여러 회차를 결제해도 각 결제에는 별도의 식별자가 생겨요.
암호화된 카드번호인가요?
빌링키는 보통 카드 결제 정보와 연결한 고유 토큰이에요. 카드번호 자체를 암호화한 값과는 다를 수 있어요. 내부 형식은 PG마다 달라요. 빌링키를 다른 PG로 옮겨 쓸 수 있는지도 해당 PG에 확인해야 해요.
운영에서 확인할 점
빌링키로 결제를 요청할 수 있으니 접근 권한을 제한해야 해요. 어떤 고객의 빌링키인지, 결제 동의를 받았는지, 해지 후 청구를 중단했는지 함께 관리해요. 카드가 재발급되거나 만료되면 새 카드 정보로 빌링키를 다시 발급해야 할 수 있어요. 빌링키에서 카드번호를 알아낼 수 없더라도 부정한 결제 요청에 악용될 위험은 있어요.
현재 PG 조건과 새 견적을 비교해 보세요
서포트비에서 한 번의 요청으로 여러 PG사의 견적을 받아 수수료와 정산 조건을 비교할 수 있어요.