콘텐츠로 건너뛰기
목차 · 찾기
위피스 설명서

토스페이먼츠로 카드 결제 받기

고객이 온라인 견적서, 쇼핑몰, 온라인 청구서에서 카드로 결제하게 하려면 결제대행업체 토스페이먼츠를 연결합니다. 고객이 결제 단추를 누르면 토스페이먼츠 결제창이 열리고, 결제가 끝나면 결제가 장부에 기록되어 청구서에 연결됩니다. 원화(KRW) 결제만 받습니다.

시작하기 전에

  • 토스페이먼츠(tosspayments.com)에 회원으로 가입합니다. 가입만 해도 시험용 키를 받을 수 있습니다. 실제 결제를 받으려면 토스페이먼츠에 결제 서비스를 신청해 가맹점 심사를 거친 뒤 운영 키를 받습니다. 가입비, 연 관리비, 결제 수수료는 토스페이먼츠와 맺는 계약에 따릅니다.
  • 토스페이먼츠를 설치하고 고쳐 저장하려면 사용자 권한에 「역할 / 관리자」가 있어야 합니다.
  • 회사 통화가 원화(KRW)여야 합니다. 위피스에서 만든 한국 회사는 처음부터 원화입니다.
  • 견적서에서 결제를 받으려면 판매 설정의 온라인 결제를 켭니다. 고객이 온라인 결제로 주문을 확정하게 하기를 봅니다.

토스페이먼츠 설치하기

  1. 회계 → 환경 설정 → 온라인 결제를 엽니다.
  2. 토스페이먼츠 카드의 설치하기를 누릅니다. 화면이 다시 열리면 설치가 끝난 것입니다.
  3. 토스페이먼츠 카드를 눌러 엽니다.

설치하면 아래 값이 저절로 들어갑니다.

  • 결제 방법 탭: Card가 켜지고, 그 아래 카드 상표 VISA, MasterCard, American Express, JCB가 함께 켜집니다. Bank Transfer(계좌이체)와 Mobile(휴대폰 결제)은 꺼져 있습니다.
  • 제한 사항 탭의 통화: KRW
  • 설정 탭 기타 묶음의 결제 분개장: 회사의 은행 분개장 하나

토스페이먼츠에서 키 받기

  1. 토스페이먼츠에 로그인해 개발자센터로 들어갑니다.
  2. API 키 메뉴에서 클라이언트 키와 시크릿 키를 확인합니다. 시험할 때는 test_ck_, test_sk_로 시작하는 테스트 키를 씁니다.

시크릿 키는 결제를 승인할 때 쓰는 비밀 값입니다. 메일이나 메신저로 주고받지 말고 바로 입력 칸에 붙여 넣습니다.

키를 넣고 시험하기

  1. 회계 → 환경 설정 → 온라인 결제에서 토스페이먼츠를 엽니다.
  2. 설정 탭 자격 증명 묶음에 키를 넣습니다.
    • 클라이언트 키: 클라이언트 키
    • Secret Key: 시크릿 키
  3. 같은 묶음의 Webhook URL 옆 복사 단추를 눌러 주소를 복사해 둡니다. 아래 「결제 상태 알림 받기」에서 씁니다.
  4. 결제 방법 탭에서 토스페이먼츠와 계약한 결제 방법만 켭니다. 계좌이체를 받으려면 Bank Transfer, 휴대폰 결제를 받으려면 Mobile을 켭니다.
  5. 위쪽의 운영은 꺼 둔 채 저장합니다. 오른쪽 위에 「테스트 모드」 띠가 붙습니다.
  6. 시험할 청구서를 하나 확정하고, 톱니바퀴 아이콘(작업)에서 결제 링크 생성을 누릅니다. 창이 열리면 결제 링크 생성 및 복사를 누릅니다.
  7. 위피스에 로그인한 그 브라우저에서 복사한 링크를 엽니다. 테스트 모드의 결제대행업체는 고객에게는 보이지 않고 로그인한 직원에게만 보입니다.
  8. 토스페이먼츠 결제 방법을 고르고 결제 단추를 누릅니다. 토스페이먼츠 결제창이 열리면 시험 결제를 마칩니다.
  9. 결제 상태 화면이 나오면 청구서로 돌아가 결제가 연결되었는지 봅니다. 토스페이먼츠 양식 위쪽의 거래 단추를 누르면 거래 목록도 볼 수 있습니다.

시험 결제도 장부에는 실제 결제로 기록됩니다. 시험이 끝나면 시험용 청구서와 결제를 정리합니다.

결제 상태 알림 받기

토스페이먼츠 쪽에서 결제 상태가 바뀌면 그 사실을 위피스로 알려 주도록 웹훅을 등록합니다. 결제창에서 위피스로 돌아오지 못한 결제(예 결제 시간이 지나 만료된 결제)의 상태를 맞추는 데 쓰입니다.

  1. 토스페이먼츠 개발자센터의 웹훅 메뉴에서 웹훅을 새로 등록합니다.
  2. 이름은 알아보기 쉽게 적고, URL 칸에 복사해 둔 Webhook URL을 붙여 넣습니다. 주소는 https://<회사 주소>/payment/toss-payments/webhook 모양입니다.
  3. 이벤트는 PAYMENT_STATUS_CHANGED를 골라 저장합니다.

실제 결제 받기

가맹점 심사가 끝나 운영 키를 받았으면 바꿔 넣습니다.

  1. 설정 탭의 클라이언트 키와 Secret Key를 운영 키로 바꿉니다.
  2. 위쪽의 운영을 켭니다. 켜면 게시 단추도 게시 완료로 함께 바뀝니다.
  3. 저장합니다. 키 칸이 비어 있으면 운영 상태로 저장되지 않습니다.

이제 고객 결제 화면에 토스페이먼츠가 나옵니다. 잠시 숨기려면 게시 완료를 눌러 게시 안 함으로 바꿉니다.

고객이 결제하는 화면

  1. 고객이 온라인 견적서의 수락 후 결제, 쇼핑몰의 결제 단계, 온라인 청구서의 결제 단추 가운데 한 곳에서 토스페이먼츠 결제 방법을 고르고 결제 단추를 누릅니다.
  2. 같은 화면 위에 토스페이먼츠 결제창이 열립니다. 고객 이름과 이메일은 미리 채워집니다. 휴대폰 번호는 연락처에 적힌 번호가 한국 전화번호 형식(예 010-1234-5678, +82 10-1234-5678)일 때만 넘어갑니다.
  3. 고객이 결제창에서 결제를 마치면 위피스가 토스페이먼츠에 결제 승인을 요청하고, 결제 상태 화면으로 돌아옵니다. 고객이 결제창을 닫으면 결제 화면에 영어 안내 「Payment not completed」가 나오고, 다시 결제할 수 있습니다.

결제가 승인되면 거래 상태가 「확인됨」이 되고 아래 일이 이어서 일어납니다.

  • 고객이 낸 금액으로 결제가 만들어져 결제 분개장에 게시됩니다. 온라인 청구서에서 낸 결제라면 그 청구서에 연결됩니다.
  • 견적서에서 낸 금액이 선결제 금액 이상이면 견적서가 판매 주문으로 확정됩니다.

알아 둘 점

  • 원화만 받습니다. 제한 사항 탭의 통화에 KRW 말고 다른 통화를 넣으면 저장되지 않습니다(안내 문구는 영어 「Currencies other than KRW are not supported.」).
  • 환불은 위피스 화면에서 할 수 없습니다. 토스페이먼츠 상점관리자에서 결제를 취소합니다. 그곳에서 취소해도 위피스의 거래와 결제는 「확인됨」 그대로 남으니 장부의 결제와 청구서는 직접 정리합니다.
  • 카드 저장과 자동 정기 결제는 되지 않습니다. 매번 고객이 결제창에서 결제합니다. 정기 요금도 회차마다 청구서 결제 링크로 받습니다.
  • 토스페이먼츠 상점관리자에 보이는 주문번호는 청구서 번호가 아니라 tx-로 시작하는 거래 참조입니다. 위피스 거래 목록에서 같은 참조로 찾습니다.
  • 결제는 고객이 낸 금액 전체로 기록됩니다. 토스페이먼츠가 수수료를 떼고 정산하므로 통장에 들어오는 금액은 이보다 적습니다.
  • Secret Key 칸은 「역할 / 관리자」에게만 보입니다.
  • 운영을 끄면 게시 상태도 함께 꺼져 고객 화면에서 사라집니다.

이어서 볼 쪽