바이브 코딩 →

결제 위젯Payment Widget

결제 위젯(Payment Widget)은 가게 계산대에 놓는 카드 단말기 같은 것 — 결제 회사가 만들어 둔 결제창을 내 사이트 결제 페이지에 끼워 넣어, 카드·간편결제 등을 바로 받을 수 있게 하는 부품이에요.

가게를 열 때 카드 단말기를 직접 만들지 않고 결제 회사에서 받아 계산대에 올려 두죠. 결제 위젯도 같아요. 카드 번호 입력, 간편결제 선택, 보안 인증 같은 복잡한 부분은 결제 회사가 만들어 두었고, 우리는 그 결제창을 내 사이트의 결제 페이지에 끼워 넣기만 하면 돼요. 카드 정보는 결제 회사가 처리하니 내 서버에 민감한 정보를 보관하지 않아도 돼요.

강의에서는 체크아웃 페이지에 토스페이먼츠 결제 위젯을 붙여요. 그리고 결제가 완료되면 구매한 강의나 전자책을 볼 수 있는 권한이 자동으로 부여되도록 설계해요. AI에게는 "체크아웃에 토스페이먼츠 결제 위젯 붙이고, 결제가 완료되면 구매한 상품 열람 권한을 자동으로 줘"처럼 결제 이후의 흐름까지 함께 설명해야 원하는 결과가 나와요.

"결제 위젯을 내 사이트에 붙이려면 어떻게 하나요?"라는 질문에는, 결제 회사에 가입해 테스트 키로 먼저 개발하고, 서버에서 결제 승인을 처리한 뒤, 심사를 거쳐 라이브 키로 바꾸는 순서라고 답할 수 있어요. 가장 위험한 실수는 브라우저에 뜬 "결제 성공" 화면만 믿고 권한을 주는 거예요. 반드시 서버에서 결제 금액과 상태를 결제 회사에 다시 확인한 뒤 주문을 확정하세요. 시크릿 키는 서버에만 두고, 환불 정책과 이용약관 페이지도 오픈 전에 준비해야 해요.

💡 대표 예시

  • 체크아웃 — 결제 페이지에 토스페이먼츠 결제 위젯을 끼워 넣는다
  • 권한 부여 — 결제 승인 뒤 구매한 강의·전자책 열람 권한을 자동으로 준다
  • 테스트 — 테스트 키로 결제·취소 흐름을 끝까지 시험해 본다
  • 검증 — 서버에서 결제 금액과 상태를 다시 확인한 뒤 주문을 확정한다
  • 오픈 준비 — 라이브 키로 바꾸기 전에 환불 정책 페이지를 만든다

🔗 관련 용어

PG 결제대행

PG 결제대행 (Payment Gateway)은 가게와 카드사 사이의 중개인 같은 것 — 온라인 사이트에서 카드·간편결제를 받을 수 있게 카드사·은행과의 결제를 대신 연결하고 처리해 주는 서비스예요.

환불 규정

환불 규정(Refund Policy)은 가게 계산대 옆에 붙은 교환·환불 안내문 같은 것 — 어떤 경우에, 언제까지, 얼마를 돌려받을 수 있는지 판매자가 미리 정해 알리는 기준이에요.

시크릿(비밀키)

시크릿(Secrets)은 은행 금고에 맡겨 둔 열쇠 같은 것 — API 키·토큰·비밀번호처럼 노출되면 안 되는 값을 코드 밖의 안전한 보관소에 따로 저장해 두고 프로그램이 실행될 때만 꺼내 쓰게 하는 방식이에요.

테스트 키·라이브 키

테스트 키·라이브 키(Test Key / Live Key)는 연습용 모형 돈과 진짜 돈 같은 것 — 결제 API에서 실제 돈이 오가지 않는 개발용 키와 실제 결제를 처리하는 운영용 키를 나눈 것이에요.

토스페이먼츠

토스페이먼츠(Toss Payments)는 가게 계산대를 대신 설치해 주는 업체 같은 것 — 내 사이트에서 카드 결제·간편결제를 받을 수 있게 연결해 주는 결제대행(PG) 서비스예요.

웹훅

웹훅 (Webhook)은 초인종 같은 것 — 누군가 누를 때만 울리듯, 특정 사건이 일어났을 때 서비스가 자동으로 내 사이트에 신호를 보내 다음 동작을 실행시키는 방식.

이 개념, 직접 적용해볼까요?

AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.